Connect SMS to Dchat with Twilio

Before you start

• Difficulty: Medium
• Time: 15 minutes
• You need: A Twilio account and an SMS-capable phone number
• You need: Admin or owner access to your Dchat workspace

Steps

1. Collect your Twilio values

   From the Twilio console, copy your Account SID and Auth Token, and note your phone number in +E.164 form (for example +14155551234).

2. Add the channel in Dchat

   In Dchat, open Settings → Channels and choose + Add channel. Pick "SMS", enter the number as the SMS sender, and paste the credentials.

   { "AccountSid": "AC...", "AuthToken": "..." }

3. Point the number at Dchat

   In Twilio, open the phone number's messaging settings and set the incoming message webhook to the URL below, method HTTP POST.

   https://api.dchat.com/api/inbound/sms/twilio

4. Send a test text

   Text the number from your phone. The conversation appears in your Dchat inbox, and the AI replies if AI is on for your workspace.

What goes in each field

• AccountSid: Starts with AC; used to send replies through Twilio.
• AuthToken: Used to send replies and to check Twilio's signature on every incoming message. Messages are rejected without it.

Good to know

• Text and MMS photos (up to 5 MB) are handled. If your Twilio account requires authentication for media, photos cannot be fetched and only the text arrives.
• Replies are plain text, without buttons.
• Each number can belong to one Dchat workspace.
• Your workspace needs at least one enabled site; new workspaces have one already. Messages are dropped while every site is switched off.
• Credentials are encrypted when you save them and are never shown again. To change one, paste the full credentials again.