Conversation Scoped Webhook Resource
Conversation Scoped Webhooks provide a way to attach a unique monitor, bot, or other integration to each conversation.
Each individual Conversation can have as many as five such webhooks, as needed for your use case. This is your go-to tool for adding:
- Third-party Bot Integrations
- Twilio Studio Integrations
- Twilio Autopilot Integrations
For bot integrations, in particular, pay specific attention to the ReplayAfter parameter to ensure that you don't miss any messages that arrive while you're configuring the integration.
ConversationScopedWebhook properties
| Resource Properties in REST API format | |
|---|---|
sid
|
A 34 character string that uniquely identifies this resource. |
account_sid
|
The unique ID of the Account responsible for this conversation. |
conversation_sid
|
The unique ID of the Conversation for this webhook. |
target
|
The target of this webhook: |
url
|
An absolute API resource URL for this webhook. |
configuration
|
The configuration of this webhook. Is defined based on target. |
date_created
|
The date that this resource was created. |
date_updated
|
The date that this resource was last updated. |
Create a ConversationScopedWebhook resource
https://conversations.twilio.com/v1/Conversations/{ConversationSid}/Webhooks
Parameters
| Parameters in REST API format | |
|---|---|
conversation_sid
Path
|
The unique ID of the Conversation for this webhook. |
target
Required
|
The target of this webhook: |
configuration.url
Optional
|
The absolute url the webhook request should be sent to. |
configuration.method
Optional
|
The HTTP method to be used when sending a webhook request. |
configuration.filters
Optional
|
The list of events, firing webhook event for this Conversation. |
configuration.triggers
Optional
|
The list of keywords, firing webhook event for this Conversation. |
configuration.flow_sid
Optional
|
The studio flow SID, where the webhook should be sent to. |
configuration.replay_after
Optional
|
The message index for which and it's successors the webhook will be replayed. Not set by default |
Example 1
Fetch a ConversationScopedWebhook resource
https://conversations.twilio.com/v1/Conversations/{ConversationSid}/Webhooks/{Sid}
Parameters
| Parameters in REST API format | |
|---|---|
conversation_sid
Path
|
The unique ID of the Conversation for this webhook. |
sid
Path
|
A 34 character string that uniquely identifies this resource. |
Example 1
Read multiple ConversationScopedWebhook resources
https://conversations.twilio.com/v1/Conversations/{ConversationSid}/Webhooks
Parameters
| Parameters in REST API format | |
|---|---|
conversation_sid
Path
|
The unique ID of the Conversation for this webhook. |
Example 1
Update a ConversationScopedWebhook resource
https://conversations.twilio.com/v1/Conversations/{ConversationSid}/Webhooks/{Sid}
Parameters
| Parameters in REST API format | |
|---|---|
conversation_sid
Path
|
The unique ID of the Conversation for this webhook. |
sid
Path
|
A 34 character string that uniquely identifies this resource. |
configuration.url
Optional
|
The absolute url the webhook request should be sent to. |
configuration.method
Optional
|
The HTTP method to be used when sending a webhook request. |
configuration.filters
Optional
|
The list of events, firing webhook event for this Conversation. |
configuration.triggers
Optional
|
The list of keywords, firing webhook event for this Conversation. |
configuration.flow_sid
Optional
|
The studio flow SID, where the webhook should be sent to. |
Example 1
Delete a ConversationScopedWebhook resource
https://conversations.twilio.com/v1/Conversations/{ConversationSid}/Webhooks/{Sid}
Parameters
| Parameters in REST API format | |
|---|---|
conversation_sid
Path
|
The unique ID of the Conversation for this webhook. |
sid
Path
|
A 34 character string that uniquely identifies this resource. |
Example 1
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.