REST Resource: projects.locations.agents.webhooks

Resource: Webhook

Webhooks host the developer's business logic. During a session, webhooks allow the developer to use the data extracted by Dialogflow's natural language processing to generate dynamic responses, validate collected data, or trigger actions on the backend.

JSON representation 
{
  "name": string,
  "displayName": string,
  "timeout": string,
  "disabled": boolean,
  "genericWebService": {
    object (GenericWebService)
  }
}
Fields
name

string

The unique identifier of the webhook. Required for the Webhooks.UpdateWebhook method. Webhooks.CreateWebhook populates the name automatically. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/webhooks/<Webhook ID>.
displayName

string

Required. The human-readable name of the webhook, unique within the agent.
timeout

string (Duration format)

Webhook execution timeout. Execution is considered failed if Dialogflow doesn't receive a response from webhook at the end of the timeout period. Defaults to 5 seconds, maximum allowed timeout is 30 seconds.

A duration in seconds with up to nine fractional digits, terminated by 's'. Example: "3.5s".
disabled

boolean

Indicates whether the webhook is disabled.
genericWebService

object (GenericWebService)

Configuration for a generic web service.

GenericWebService

Represents configuration for a generic web service.

JSON representation 
{
  "uri": string,
  "username": string,
  "password": string,
  "requestHeaders": {
    string: string,
    ...
  }
}
Fields
uri

string

Required. The webhook URI for receiving POST requests. It must use https protocol.
username
(deprecated)

string

The user name for HTTP Basic authentication.
password
(deprecated)

string

The password for HTTP Basic authentication.
requestHeaders

map (key: string, value: string)

The HTTP request headers to send together with webhook requests.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Methods

create

 Creates a webhook in the specified agent.

delete

 Deletes the specified webhook.

get

 Retrieves the specified webhook.

list

 Returns the list of all webhooks in the specified agent.

patch

 Updates the specified webhook.