The Address Configuration resource manages the configurations related to a unique address within the Conversations product, allowing you to specify which addresses should auto-create a Conversation upon receiving an inbound message.
The unique address must be a single address (i.e. a WhatsApp or SMS phone number) that belongs to your Twilio Account.
The configuration can optionally include automatically attaching a Conversation-scoped Webhook to the auto-created conversations.
The unique address to be configured. The address can be a whatsapp address or phone number
The human-readable name of this configuration, limited to 256 characters. Optional.
An ISO 3166-1 alpha-2n country code which the address belongs to. This is currently only applicable to short code addresses.
POST https://conversations.twilio.com/v1/Configuration/Addresses
Type of Address. Value can be whatsapp
or sms
.
sms
whatsapp
messenger
gbm
email
The unique address to be configured. The address can be a whatsapp address or phone number
The human-readable name of this configuration, limited to 256 characters. Optional.
Enable/Disable auto-creating conversations for messages to this address
Type of Auto Creation. Value can be one of webhook
, studio
or default
. default
creates a new Conversation under the default Conversation service, without a webhook or Studio integration.
webhook
studio
default
Conversation Service for the auto-created conversation. If not set, the conversation is created in the default service.
For type webhook
, the HTTP method to be used when sending a webhook request.
GET
POST
The list of events, firing webhook event for this Conversation. Values can be any of the following: onMessageAdded
, onMessageUpdated
, onMessageRemoved
, onConversationUpdated
, onConversationStateUpdated
, onConversationRemoved
, onParticipantAdded
, onParticipantUpdated
, onParticipantRemoved
, onDeliveryUpdated
For type studio
, the studio flow SID where the webhook should be sent to.
For type studio
, number of times to retry the webhook request
An ISO 3166-1 alpha-2n country code which the address belongs to. This is currently only applicable to short code addresses.
GET https://conversations.twilio.com/v1/Configuration/Addresses/{Sid}
The SID of the Address Configuration resource. This value can be either the sid
or the address
of the configuration
GET https://conversations.twilio.com/v1/Configuration/Addresses
Filter the address configurations by its type. This value can be one of: whatsapp
, sms
.
How many resources to return in each list page. The default is 50, and the maximum is 1000.
POST https://conversations.twilio.com/v1/Configuration/Addresses/{Sid}
The SID of the Address Configuration resource. This value can be either the sid
or the address
of the configuration
The human-readable name of this configuration, limited to 256 characters. Optional.
Enable/Disable auto-creating conversations for messages to this address
Type of Auto Creation. Value can be one of webhook
, studio
or default
.
webhook
studio
default
Conversation Service for the auto-created conversation. If not set, the conversation is created in the default service.
For type webhook
, the HTTP method to be used when sending a webhook request.
GET
POST
The list of events, firing webhook event for this Conversation. Values can be any of the following: onMessageAdded
, onMessageUpdated
, onMessageRemoved
, onConversationUpdated
, onConversationStateUpdated
, onConversationRemoved
, onParticipantAdded
, onParticipantUpdated
, onParticipantRemoved
, onDeliveryUpdated
For type studio
, the studio flow SID where the webhook should be sent to.
For type studio
, number of times to retry the webhook request
DELETE https://conversations.twilio.com/v1/Configuration/Addresses/{Sid}
The SID of the Address Configuration resource. This value can be either the sid
or the address
of the configuration