# Google Dialogflow

> Dialogflow is Google Cloud's conversational-agent platform. It ships as two editions on one API
> host: Dialogflow ES (Essentials, API v2) builds intent-and-context agents, and Dialogflow CX —
> now branded Conversational Agents — builds flow-based and generative playbook-based agents on
> API v3. Both are called at https://dialogflow.googleapis.com with a Google OAuth 2.0 bearer
> token. Google publishes no OpenAPI; the first-party machine-readable contract is a Google
> Discovery Document served by the API host itself, plus protobuf IDL in googleapis/googleapis.

Generated by API Evangelist on 2026-09-12 from the artifacts in
https://github.com/api-evangelist/google-dialogflow. Provenance: generated (method: generated).
Every URL below was fetched or derived from a first-party source; nothing is inferred.

## What you need to know before calling it

- Base URL: https://dialogflow.googleapis.com (regional CX agents use https://{region}-dialogflow.googleapis.com)
- Auth: OAuth 2.0 bearer token only. No API key. Two scopes exist and every one of the 437
  operations declares both: https://www.googleapis.com/auth/dialogflow and
  https://www.googleapis.com/auth/cloud-platform
- Errors: google.rpc.Status, not RFC 9457. Branch on error.status (the canonical gRPC name), not on
  error.message.
- Idempotency: none. There is no Idempotency-Key header, no ETag and no If-Match anywhere in the
  contract. A retried create makes a second resource; a retried conversation turn is billed twice.
- Partial update: every PATCH takes an updateMask query parameter. Omitting it REPLACES the whole
  resource.
- Pagination: pageSize + pageToken in, nextPageToken out, on every list operation.
- Long-running work: imports, exports, training, restores and batch operations return a
  google.longrunning.Operation. The response is not the result — poll until done:true.
- Rate limits: published as per-project, per-minute quotas, but NO rate-limit response headers are
  returned. On 429 back off 1 second and double up to 32 seconds (the SLA makes this a customer
  obligation, not advice).
- Billing: every runtime turn is billed, including from the console. Design-time requests are free.

## First-party machine-readable contracts

- Discovery Document, Dialogflow ES v2 (279 operations): https://dialogflow.googleapis.com/$discovery/rest?version=v2
- Discovery Document, Dialogflow ES v2beta1 (266 operations): https://dialogflow.googleapis.com/$discovery/rest?version=v2beta1
- Discovery Document, Dialogflow CX v3 (158 operations): https://dialogflow.googleapis.com/$discovery/rest?version=v3
- Discovery Document, Dialogflow CX v3beta1 (162 operations): https://dialogflow.googleapis.com/$discovery/rest?version=v3beta1
- Protobuf IDL, Dialogflow ES v2 (22 gRPC services, 130 RPCs): https://github.com/googleapis/googleapis/tree/master/google/cloud/dialogflow/v2
- Protobuf IDL, Dialogflow CX v3 (20 gRPC services, 137 RPCs): https://github.com/googleapis/googleapis/tree/master/google/cloud/dialogflow/cx/v3

Note for anyone generating a client from the Discovery Documents: they carry NO method, schema or
parameter descriptions — every description field is an empty string. The prose lives only in the
HTML reference below.

## Documentation

- Dialogflow documentation home: https://cloud.google.com/dialogflow/docs
- Dialogflow CX (Conversational Agents) docs: https://cloud.google.com/dialogflow/cx/docs
- Dialogflow ES docs: https://cloud.google.com/dialogflow/es/docs
- REST reference, CX v3: https://cloud.google.com/dialogflow/cx/docs/reference/rest
- REST reference, ES v2: https://cloud.google.com/dialogflow/es/docs/reference/rest/v2-overview
- Authentication and access control (ES): https://cloud.google.com/dialogflow/es/docs/access-control
- Authentication and access control (CX): https://cloud.google.com/dialogflow/cx/docs/concept/access-control
- Google Cloud authentication overview: https://cloud.google.com/docs/authentication
- Quickstart (ES): https://cloud.google.com/dialogflow/es/docs/quick/setup
- Quickstart, build an agent: https://cloud.google.com/dialogflow/es/docs/quick/build-agent
- Google Cloud API design guide (the conventions Dialogflow follows): https://cloud.google.com/apis/design

## Operations, limits and money

- Pricing: https://cloud.google.com/dialogflow/pricing — Flows chat $0.007/request, Playbooks chat
  $0.012/request, Flows voice $0.001/second, Playbooks voice $0.002/second, data-store index
  storage 10 GiB free then $5.00/GiB/month. New-user trial credits: $600 Flows, $1000 Playbooks,
  expiring after 12 months.
- Quotas and limits: https://cloud.google.com/dialogflow/quotas — CX text 1200 rpm, CX audio 600
  rpm, generative 600,000 tokens/minute per model per region, design-time writes 60 rpm, design-time
  reads 300 rpm (CX) / 60 rpm (ES).
- SLA: https://cloud.google.com/dialogflow/sla — 99.9% monthly uptime, Essentials and Customer
  Experience editions only; the Trial Edition is not covered.
- Status: https://status.cloud.google.com/ (machine-readable at
  https://status.cloud.google.com/incidents.json)
- Release notes: https://cloud.google.com/dialogflow/docs/release-notes
  (Atom feed: https://docs.cloud.google.com/feeds/dialogflow-release-notes.xml)
- Support: https://cloud.google.com/dialogflow/docs/support
- Compliance and security controls: https://cloud.google.com/dialogflow/docs/compliance-security-controls
  — HIPAA, ISO 27001/27017/27018/27701, SOC 1/2/3 on both editions; FedRAMP High, CMEK and Access
  Transparency on CX only.

## Client libraries (all first-party, versions read from the registries on 2026-09-12)

- Node.js: @google-cloud/dialogflow 8.1.0 (2026-09-08), @google-cloud/dialogflow-cx 6.1.0 (2026-09-08)
- Python: google-cloud-dialogflow 2.51.0 (2026-07-16), google-cloud-dialogflow-cx 2.7.0 (2026-06-25)
- Java: com.google.cloud:google-cloud-dialogflow 4.99.0 (2026-06-04), :google-cloud-dialogflow-cx 0.104.0 (2026-06-04)
- .NET: Google.Cloud.Dialogflow.V2 4.31.0 (2026-06-29), Google.Cloud.Dialogflow.Cx.V3 3.1.0 (2026-03-30)
- Go: cloud.google.com/go/dialogflow v1.85.0 (2026-07-20), CX as the .../cx subpackage
- Ruby: google-cloud-dialogflow 1.15.1, google-cloud-dialogflow-cx 1.5.1 (both 2026-08-05)
- PHP: google/cloud-dialogflow v2.6.1, google/cloud-dialogflow-cx v0.12.1 (both 2026-09-01)
- Do not use the npm package named `dialogflow` — last published 2020-02-07 and superseded.

## CLI and console

- CLI: gcloud alpha dialogflow — https://cloud.google.com/sdk/gcloud/reference/alpha/dialogflow
  Groups: agent (describe, export, import, query, train), entity-types, intents. ES only, still
  ALPHA, and there is no CX command group.
- Conversational Agents console: https://dialogflow.cloud.google.com/cx
- Dialogflow ES console: https://dialogflow.cloud.google.com/

## Embeddable surfaces

- Dialogflow Messenger web component <df-messenger>:
  https://cloud.google.com/dialogflow/cx/docs/concept/integration/dialogflow-messenger
  Loader: https://www.gstatic.com/dialogflow-console/fast/df-messenger/prod/v1/df-messenger.js
  (unpinned — the URL names only the prod/v1 channel, so you cannot tell which build you get).

## Events

- Dialogflow calls YOUR endpoint. Webhook fulfillment is a synchronous HTTPS callback on the
  critical path of a billed turn, not a fire-and-forget notification:
  https://cloud.google.com/dialogflow/cx/docs/concept/webhook
- Webhooks are managed API resources in CX (create/list/patch/delete), max 100 per agent.
- Agent Assist conversation events are published to Cloud Pub/Sub.
- No AsyncAPI document is published.

## Agent surfaces

- MCP: Google ships no Model Context Protocol server for Dialogflow. Searched npm and the
  GoogleCloudPlatform and googleapis GitHub orgs on 2026-09-12 — they publish MCP servers for Cloud
  Run, GKE, BigQuery and others, but not for Dialogflow. A candidate tool list derived from real
  operations is in mcp/google-dialogflow-mcp.yml in the repo.
- A2A: no agent card. /.well-known/agent-card.json and /.well-known/agent.json 404 on
  dialogflow.googleapis.com, google.com and developers.google.com; the 200s on cloud.google.com and
  dialogflow.cloud.google.com are HTML shells, not cards.
- Dialogflow CX is a tool CONSUMER: its `tools` resource (max 100 per agent) lets the agent you
  build call external APIs. Nothing lets an external agent client reach in.

## Security

- security.txt: https://www.google.com/.well-known/security.txt (Policy https://g.co/vrp, Contact
  https://g.co/vulnz)
- OAuth authorization server metadata:
  https://accounts.google.com/.well-known/oauth-authorization-server
- OpenID Connect discovery: https://accounts.google.com/.well-known/openid-configuration
- Terms: https://cloud.google.com/terms | Privacy: https://policies.google.com/privacy

## Optional

- Blog: https://cloud.google.com/blog/products/ai-machine-learning
- GitHub samples: https://github.com/GoogleCloudPlatform/python-docs-samples
- Prebuilt starter agents: https://cloud.google.com/dialogflow/es/docs/agents-prebuilt