AI Agents: Dialogflow

Update Dialogflow agent

Updates how SignalWire connects to and presents a Dialogflow-backed AI Agent. This changes the linked resource in your SignalWire project, not the agent hosted in Dialogflow. Use Update AI agent for an agent configured directly in SignalWire.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Voice, Messaging, Fax, or Video.

Learn more about API scopes.

put/api/fabric/resources/dialogflow_agents/{id}

Path parameters

idstring uuid required

Universal Unique Identifier.

Unique ID of a Dialogflow Agent.

Request body

namestring

Name of the Dialogflow Agent

say_enabledboolean

Whether to enable the 'say' feature

saystring

Default message to say

voicestring

Voice to use for speech

Example request

{
  "name": "Booking Assistant",
  "say_enabled": true,
  "say": "Welcome to the Booking Assistant",
  "voice": "en-US-Wavenet-D"
}

Response

The request has succeeded.

idstring uuid required

Universal Unique Identifier.

project_idstring uuid required

Universal Unique Identifier.

display_namestring required

Display name of the Dialogflow Agent Fabric Resource

type'dialogflow_agent' required

Type of the Fabric Resource

created_atstring date-time required

Date and time when the resource was created.

updated_atstring date-time required

Date and time when the resource was updated.

Example response

{
  "display_name": "Customer Service Agent",
  "type": "dialogflow_agent",
  "created_at": "2024-05-06T12:20:00Z",
  "updated_at": "2024-05-06T12:20:00Z",
  "dialogflow_agent": {
    "say_enabled": true,
    "say": "Welcome to the Booking Assistant",
    "voice": "en-US-Wavenet-D",
    "display_name": "Booking Assistant",
    "dialogflow_reference_name": "my dialogflow agent"
  }
}

Changes

No changes found, but 3 of the 137 revisions have a changelog that could not be searched — this endpoint may have changed in one of them.