\r \r

Dialogflow CX Advanced\r

\r Manage advanced features in Google Dialogflow CX via REST API for deployment and external integrations.\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 Environments\r
```bash\r
curl -X GET \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}/environments" \\r
  -H "Authorization: Bearer ${TOKEN}"\r
```\r
\r
### Create Environment\r
```bash\r
curl -X POST \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}/environments" \\r
  -H "Authorization: Bearer ${TOKEN}" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "displayName": "production",\r
    "description": "Production environment"\r
  }'\r
```\r
\r
### List Webhooks\r
```bash\r
curl -X GET \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}/webhooks" \\r
  -H "Authorization: Bearer ${TOKEN}"\r
```\r
\r
### Create Webhook\r
```bash\r
curl -X POST \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}/webhooks" \\r
  -H "Authorization: Bearer ${TOKEN}" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "displayName": "Order Fulfillment",\r
    "genericWebService": {\r
      "uri": "https://your-webhook.com/fulfill"\r
    }\r
  }'\r
```\r
\r
## Key Resources\r
\r
| Resource | Description |\r
|----------|-------------|\r
| **Environments** | Deployment stages (draft, production) |\r
| **Webhooks** | External fulfillment endpoints |\r
| **Continuous Testing** | Ongoing health monitoring |\r
\r
## Quick Reference\r
\r
For detailed API reference:\r
- **Advanced Features**: See [references/advanced.md](references/advanced.md)\r
\r
## Scripts\r
\r
- `scripts/advanced.py` — CLI wrapper for advanced operations\r
\r
### Usage\r
```bash\r
python scripts/advanced.py list-environments --agent AGENT_NAME\r
python scripts/advanced.py list-webhooks --agent AGENT_NAME\r
```\r
\r
## Tips\r
\r
- Use environments to separate development, staging, and production\r
- Webhooks enable external processing and integrations\r
- Continuous testing helps maintain conversation quality\r