\r \r

Dialogflow CX Conversations\r

\r Manage conversations and sessions in Google Dialogflow CX via REST API for testing and interaction handling.\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
### Detect Intent\r
```bash\r
curl -X POST \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}/sessions/${SESSION_ID}:detectIntent" \\r
  -H "Authorization: Bearer ${TOKEN}" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "queryInput": {\r
      "text": {\r
        "text": "Hello"\r
      },\r
      "languageCode": "en"\r
    }\r
  }'\r
```\r
\r
### Match Intent (no state change)\r
```bash\r
curl -X POST \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}/sessions/${SESSION_ID}:matchIntent" \\r
  -H "Authorization: Bearer ${TOKEN}" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "queryInput": {\r
      "text": {\r
        "text": "Hello"\r
      },\r
      "languageCode": "en"\r
    }\r
  }'\r
```\r
\r
### Create Test Case\r
```bash\r
curl -X POST \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}/testCases" \\r
  -H "Authorization: Bearer ${TOKEN}" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "displayName": "Greeting Test",\r
    "testCaseConversationTurns": [\r
      {\r
        "userInput": {\r
          "input": {\r
            "text": {\r
              "text": "Hi"\r
            }\r
          }\r
        },\r
        "virtualAgentOutput": {\r
          "textResponses": [\r
            {\r
              "text": ["Hello!"]\r
            }\r
          ]\r
        }\r
      }\r
    ]\r
  }'\r
```\r
\r
## Key Resources\r
\r
| Resource | Description |\r
|----------|-------------|\r
| **Sessions** | Conversation instances with state |\r
| **Detect Intent** | Process user input and get responses |\r
| **Test Cases** | Automated conversation testing |\r
\r
## Quick Reference\r
\r
For detailed API reference:\r
- **Conversations & Testing**: See [references/conversations.md](references/conversations.md)\r
\r
## Scripts\r
\r
- `scripts/conversations.py` — CLI wrapper for conversation operations\r
\r
### Usage\r
```bash\r
python scripts/conversations.py detect-intent --agent AGENT_NAME --text "Hello"\r
python scripts/conversations.py match-intent --agent AGENT_NAME --text "Hello"\r
```\r
\r
## Tips\r
\r
- Session IDs can be any unique string (e.g., UUID)\r
- Use detectIntent for full conversation flow, matchIntent for testing without state changes\r
- Test cases help validate conversation logic before deployment\r