Skip to content Skip to navigation Skip to topbar

Page tools

Useful for sharing or LLM

Accelerate development with AI

On this page

Looking for more inspiration?Visit the

Service-Scoped Notification Resource

The Twilio Conversations (classic) Service Notification resource manages a set of settings to determine push notification Service Binding behavior for a specific Conversation Service.

API Base URL

All URLs in the reference documentation use the following base URL:

1https://conversations.twilio.com/v1
2

For Conversations (classic) applications that build on more than one Conversation Service instance, you will need to specify the Conversation Service SID in the REST API call:

1GET /v1/Services/ISxx/Conversations/CHxx/Messages
2

Notification Properties

Property nameTypeRequiredPIIDescriptionChild properties

accountSidSID<AC>

Optional

The unique ID of the Account responsible for this configuration.

Pattern: ^AC[0-9a-fA-F]{32}$Min length: 34Max length: 34

chatServiceSidSID<IS>

Optional

The SID of the Conversation Service the Configuration applies to.

Pattern: ^IS[0-9a-fA-F]{32}$Min length: 34Max length: 34

newMessage

Optional

The Push Notification configuration for New Messages.

addedToConversation

Optional

The Push Notification configuration for being added to a Conversation.

removedFromConversation

Optional

The Push Notification configuration for being removed from a Conversation.

logEnabledboolean

Optional

Weather the notification logging is enabled.

urlstring<uri>

Optional

An absolute API resource URL for this configuration.

Fetch a ServiceNotification resource

GET https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Configuration/Notifications

Path parameters

Property nameTypeRequiredPIIDescription

chatServiceSidSID<IS>

required

The SID of the Conversation Service the Configuration applies to.

Pattern: ^IS[0-9a-fA-F]{32}$Min length: 34Max length: 34

Fetch push notification service settings

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID at twilio.com/console
5// Provision API Keys at twilio.com/console/runtime/api-keys
6// and set the environment variables. See http://twil.io/secure
7// For local testing, you can use your Account SID and Auth token
8const accountSid = process.env.TWILIO_ACCOUNT_SID;
9const apiKey = process.env.TWILIO_API_KEY;
10const apiSecret = process.env.TWILIO_API_SECRET;
11const client = twilio(apiKey, apiSecret, { accountSid: accountSid });
12
13async function fetchServiceNotification() {
14  const notification = await client.conversations.v1
15    .services("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
16    .configuration.notifications()
17    .fetch();
18
19  console.log(notification.accountSid);
20}
21
22fetchServiceNotification();

Response

1{
2  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
3  "chat_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
4  "log_enabled": false,
5  "added_to_conversation": {
6    "enabled": true,
7    "template": "You have been added to a Conversation: ${CONVERSATION}",
8    "sound": "ring"
9  },
10  "new_message": {
11    "enabled": true,
12    "template": "You have a new message in ${CONVERSATION} from ${PARTICIPANT}: ${MESSAGE}",
13    "badge_count_enabled": false,
14    "sound": "ring",
15    "with_media": {
16      "enabled": false,
17      "template": "You have a new message in ${CONVERSATION} with ${MEDIA_COUNT} media files: ${MEDIA}"
18    }
19  },
20  "removed_from_conversation": {
21    "enabled": true,
22    "template": "You have been removed from a Conversation: ${CONVERSATION}",
23    "sound": "ring"
24  },
25  "url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Configuration/Notifications"
26}

Update a ServiceNotification resource

POST https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Configuration/Notifications

Path parameters

Property nameTypeRequiredPIIDescription

chatServiceSidSID<IS>

required

The SID of the Conversation Service the Configuration applies to.

Pattern: ^IS[0-9a-fA-F]{32}$Min length: 34Max length: 34

Request body parameters

Encoding type:application/x-www-form-urlencoded

SchemaExample

Property nameTypeRequiredPIIDescriptionChild properties

logEnabledboolean

Optional

Weather the notification logging is enabled.

newMessage.enabledboolean

Optional

Whether to send a notification when a new message is added to a conversation. The default is false.

newMessage.templatestring

Optional

The template to use to create the notification text displayed when a new message is added to a conversation and new_message.enabled is true.

newMessage.soundstring

Optional

The name of the sound to play when a new message is added to a conversation and new_message.enabled is true.

newMessage.badgeCountEnabledboolean

Optional

Whether the new message badge is enabled. The default is false.

addedToConversation.enabledboolean

Optional

Whether to send a notification when a participant is added to a conversation. The default is false.

addedToConversation.templatestring

Optional

The template to use to create the notification text displayed when a participant is added to a conversation and added_to_conversation.enabled is true.

addedToConversation.soundstring

Optional

The name of the sound to play when a participant is added to a conversation and added_to_conversation.enabled is true.

removedFromConversation.enabledboolean

Optional

Whether to send a notification to a user when they are removed from a conversation. The default is false.

removedFromConversation.templatestring

Optional

The template to use to create the notification text displayed to a user when they are removed from a conversation and removed_from_conversation.enabled is true.

removedFromConversation.soundstring

Optional

The name of the sound to play to a user when they are removed from a conversation and removed_from_conversation.enabled is true.

newMessage.withMedia.enabledboolean

Optional

Whether to send a notification when a new message with media/file attachments is added to a conversation. The default is false.

newMessage.withMedia.templatestring

Optional

The template to use to create the notification text displayed when a new message with media/file attachments is added to a conversation and new_message.attachments.enabled is true.

Update push notification service settings

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID at twilio.com/console
5// Provision API Keys at twilio.com/console/runtime/api-keys
6// and set the environment variables. See http://twil.io/secure
7// For local testing, you can use your Account SID and Auth token
8const accountSid = process.env.TWILIO_ACCOUNT_SID;
9const apiKey = process.env.TWILIO_API_KEY;
10const apiSecret = process.env.TWILIO_API_SECRET;
11const client = twilio(apiKey, apiSecret, { accountSid: accountSid });
12
13async function updateServiceNotification() {
14  const notification = await client.conversations.v1
15    .services("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
16    .configuration.notifications()
17    .update({ logEnabled: false });
18
19  console.log(notification.accountSid);
20}
21
22updateServiceNotification();

Response

1{
2  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
3  "chat_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
4  "log_enabled": false,
5  "added_to_conversation": {
6    "enabled": false,
7    "template": "You have been added to a Conversation: ${CONVERSATION}",
8    "sound": "ring"
9  },
10  "new_message": {
11    "enabled": false,
12    "template": "You have a new message in ${CONVERSATION} from ${PARTICIPANT}: ${MESSAGE}",
13    "badge_count_enabled": true,
14    "sound": "ring",
15    "with_media": {
16      "enabled": false,
17      "template": "You have a new message in ${CONVERSATION} with ${MEDIA_COUNT} media files: ${MEDIA}"
18    }
19  },
20  "removed_from_conversation": {
21    "enabled": false,
22    "template": "You have been removed from a Conversation: ${CONVERSATION}",
23    "sound": "ring"
24  },
25  "url": "https://conversations.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Configuration/Notifications"
26}