\r \r

Dialogflow CX Flows\r

\r Manage flows and pages in Google Dialogflow CX via REST API for organizing conversation paths.\r \r

Prerequisites\r

\r

• Google Cloud project with Dialogflow CX API enabled\r
• Service account or OAuth credentials with Dialogflow API access\r
• gcloud CLI authenticated OR bearer token\r \r

Authentication\r

\r

Option 1: gcloud CLI (recommended)\r

gcloud auth application-default login\r
TOKEN=$(gcloud auth print-access-token)\r
```\r
\r
### Option 2: Service Account\r
```bash\r
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"\r
TOKEN=$(gcloud auth application-default print-access-token)\r
```\r
\r
## API Base URL\r
\r
```\r
https://dialogflow.googleapis.com/v3beta1\r
```\r
\r
Regional endpoints available:\r
- `https://{region}-dialogflow.googleapis.com` (e.g., `us-central1`, `europe-west1`)\r
\r
## Common Operations\r
\r
### List Flows\r
```bash\r
curl -X GET \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}/flows" \\r
  -H "Authorization: Bearer ${TOKEN}"\r
```\r
\r
### Create Flow\r
```bash\r
curl -X POST \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}/flows" \\r
  -H "Authorization: Bearer ${TOKEN}" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "displayName": "Booking Flow",\r
    "description": "Handles flight booking conversations"\r
  }'\r
```\r
\r
### List Pages\r
```bash\r
curl -X GET \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}/flows/${FLOW_ID}/pages" \\r
  -H "Authorization: Bearer ${TOKEN}"\r
```\r
\r
### Create Page\r
```bash\r
curl -X POST \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}/flows/${FLOW_ID}/pages" \\r
  -H "Authorization: Bearer ${TOKEN}" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "displayName": "Collect Destination",\r
    "entryFulfillment": {\r
      "messages": [\r
        {\r
          "text": {\r
            "text": ["Where would you like to fly?"]\r
          }\r
        }\r
      ]\r
    }\r
  }'\r
```\r
\r
## Key Resources\r
\r
| Resource | Description |\r
|----------|-------------|\r
| **Flows** | Conversation paths within an agent |\r
| **Pages** | States within a flow |\r
| **Transition Routes** | Routing logic between pages |\r
| **Versions** | Immutable snapshots of flows |\r
\r
## Quick Reference\r
\r
For detailed API reference:\r
- **Flows & Pages**: See [references/flows.md](references/flows.md)\r
\r
## Scripts\r
\r
- `scripts/flows.py` — CLI wrapper for flows and pages operations\r
\r
### Usage\r
```bash\r
python scripts/flows.py list-flows --agent AGENT_NAME\r
python scripts/flows.py list-pages --flow FLOW_NAME\r
python scripts/flows.py get-flow --flow FLOW_NAME\r
python scripts/flows.py get-page --page PAGE_NAME\r
```\r
\r
## Tips\r
\r
- Every agent has a default "Default Start Flow"\r
- Pages represent conversation states\r
- Use transition routes to move between pages based on intents or conditions\r
- Train flows after making changes to update NLU\r