Setting Up the SMS Channel

The SMS channel allows sending text and MMS messages (with images) to phone numbers in E.164 format. The integration is done via Twilio, the SMS provider used by the platform.

Prerequisites

• Twilio account credentials (provided by the Hub Chatt2.me team)
• Origin number configured in Twilio

Connecting the channel

In the Hub Chatt2.me dashboard:

1. Go to Channels → Activate/Configure → SMS
2. Enter the Twilio credentials:
   • Account SID
   • Auth Token
3. Select or enter the origin number
4. Click Connect

Configuring the Twilio webhook (required for inbound SMS)

For Hub Chatt2.me to receive incoming messages, configure the Twilio phone number in the Twilio Console:

1. In Twilio, go to Phone Numbers → Manage → Active Numbers
2. Click the number you connected to Hub
3. Under Messaging, find A message comes in
4. Set the webhook to:
   • Method: HTTP POST
   • URL: https://app.chatt2.me/v1/communication/webhook/sms
5. Click Save

Without this step, Hub will not receive replies or inbound SMS.

Identifying the recipient (to)

The to field in SMS must be a number in E.164 format, including the country code preceded by +:

Country	Example
Brazil	+5511944574999
USA	+12025551234
Portugal	+351912345678

Supported content types

Type	Supported	Notes
Text	✅	text field
Image + text	✅	text + imageUrl fields (MMS)
Video	❌
Audio	❌
Document	❌
Interactive	❌

Sending plain text

{
  "from": "sms-channel-uuid",
  "to": "+5511944574999",
  "content": {
    "text": "Hello! Your order has been confirmed."
  }
}

Sending an image with text (MMS)

{
  "from": "sms-channel-uuid",
  "to": "+5511944574999",
  "content": {
    "text": "Check out our promotion!",
    "imageUrl": "https://example.com/promo.jpg"
  }
}

MMS vs SMS

Messages with images are sent as MMS and may have a different cost from text SMS. Check the plan contracted with Twilio.

Limitations

• SMS does not support interactive messages, stickers, location, contacts, documents, or reactions
• Character limit per SMS: 160 (ASCII) or 70 (Unicode/UTF-8) — longer messages are split automatically
• MMS has variable support across carriers and countries

Identifying the sender (from)

In POST /v1/communication/sms/message, set from to the application channel UUID or the sender phone number configured for that channel (with or without a leading +). The UUID always works as a fallback. See Sending messages overview.

Next steps

• Sending messages overview