The Twilio Conversations' Configuration resource represents settings applied at the account level, across all Conversation Services.
The SID of the Account responsible for this configuration.
^AC[0-9a-fA-F]{32}$
Min length: 34
Max length: 34
The SID of the default Conversation Service used when creating a conversation.
^IS[0-9a-fA-F]{32}$
Min length: 34
Max length: 34
The SID of the default Messaging Service used when creating a conversation.
^MG[0-9a-fA-F]{32}$
Min length: 34
Max length: 34
Default ISO8601 duration when conversation will be switched to inactive
state. Minimum value for this timer is 1 minute.
Default ISO8601 duration when conversation will be switched to closed
state. Minimum value for this timer is 10 minutes.
Contains absolute API resource URLs to access the webhook and default service configurations.
GET https://conversations.twilio.com/v1/Configuration
1// Download the helper library from https://www.twilio.com/docs/node/install2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";34// Find your Account SID and Auth Token at twilio.com/console5// and set the environment variables. See http://twil.io/secure6const accountSid = process.env.TWILIO_ACCOUNT_SID;7const authToken = process.env.TWILIO_AUTH_TOKEN;8const client = twilio(accountSid, authToken);910async function fetchConfiguration() {11const configuration = await client.conversations.v1.configuration().fetch();1213console.log(configuration.accountSid);14}1516fetchConfiguration();
1{2"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",3"default_chat_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",4"default_messaging_service_sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",5"default_inactive_timer": "PT1M",6"default_closed_timer": "PT10M",7"url": "https://conversations.twilio.com/v1/Configuration",8"links": {9"service": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Configuration",10"webhooks": "https://conversations.twilio.com/v1/Configuration/Webhooks"11}12}
POST https://conversations.twilio.com/v1/Configuration
application/x-www-form-urlencoded
The SID of the default Conversation Service to use when creating a conversation.
^IS[0-9a-fA-F]{32}$
Min length: 34
Max length: 34
The SID of the default Messaging Service to use when creating a conversation.
^MG[0-9a-fA-F]{32}$
Min length: 34
Max length: 34
Default ISO8601 duration when conversation will be switched to inactive
state. Minimum value for this timer is 1 minute.
Default ISO8601 duration when conversation will be switched to closed
state. Minimum value for this timer is 10 minutes.
1// Download the helper library from https://www.twilio.com/docs/node/install2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";34// Find your Account SID and Auth Token at twilio.com/console5// and set the environment variables. See http://twil.io/secure6const accountSid = process.env.TWILIO_ACCOUNT_SID;7const authToken = process.env.TWILIO_AUTH_TOKEN;8const client = twilio(accountSid, authToken);910async function updateConfiguration() {11const configuration = await client.conversations.v112.configuration()13.update({ defaultChatServiceSid: "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" });1415console.log(configuration.accountSid);16}1718updateConfiguration();
1{2"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",3"default_chat_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",4"default_messaging_service_sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",5"default_inactive_timer": "PT1M",6"default_closed_timer": "PT10M",7"url": "https://conversations.twilio.com/v1/Configuration",8"links": {9"service": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Configuration",10"webhooks": "https://conversations.twilio.com/v1/Configuration/Webhooks"11}12}