ConversationsWebhook

Update Service Conversation Scoped Webhook

POST
/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Webhooks/{Sid}

Update an existing conversation-scoped webhook

Authorization

accountSid_authToken
AuthorizationBasic <token>

In: header

Path Parameters

ChatServiceSid*string

The SID of the Conversation Service the Participant resource is associated with.

Match^IS[0-9a-fA-F]{32}$
Length34 <= length <= 34
ConversationSid*string

The unique ID of the Conversation for this webhook.

Sid*string

A 34 character string that uniquely identifies this resource.

Match^WH[0-9a-fA-F]{32}$
Length34 <= length <= 34

Request Body

application/x-www-form-urlencoded

Configuration.Url?string

The absolute url the webhook request should be sent to.

Configuration.Method?ServiceConversationScopedWebhookMethod

Value in

  • "get"
  • "post"
Configuration.Filters?array<string>

The list of events, firing webhook event for this Conversation.

Configuration.Triggers?array<string>

The list of keywords, firing webhook event for this Conversation.

Configuration.FlowSid?string

The studio flow SID, where the webhook should be sent to.

Match^FW[0-9a-fA-F]{32}$
Length34 <= length <= 34

Response Body

application/json

curl -X POST "https://example.com/v1/Services/stringstringstringstringstringstri/Conversations/string/Webhooks/stringstringstringstringstringstri" \  -H "Content-Type: application/x-www-form-urlencoded" \  -d 'Configuration.Url=https%3A%2F%2Fexample.com&Configuration.Method=post&Configuration.Triggers=keyword1%2Ckeyword2'
{  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "chat_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "conversation_sid": "CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "sid": "WHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "target": "trigger",  "configuration": {    "url": "https://example.com",    "method": "post",    "filters": [      "keyword1",      "keyword2"    ]  },  "date_created": "2016-03-24T21:05:50Z",  "date_updated": "2016-03-24T21:05:51Z",  "url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Conversations/CHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Webhooks/WHaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}