Setup

This page explains how to connect Twilio so TatTool can send SMS (flows and send messages).

---

1. Install The Extension

1. Go to Extensions
2. Install Twilio SMS

---

2. Configure The Sender Phone Number

In Twilio SMS → Settings → Phone Number:

• Enter the Twilio phone number you want to send from (E.164 format, like +14155552671)

---

3. Configure Credentials

In Twilio SMS → Settings → Credentials:

• Account SID (starts with AC...)
• Auth token (stored encrypted)

Only owners/admins can update these settings.

---

4. Send A Test SMS

In Twilio SMS → Settings → Test SMS:

• Send a test message to your own phone (E.164 format)

If the test works, you’re ready to use Twilio SMS in flows.

---

5. Configure Delivery Webhooks (Recommended)

In Twilio SMS → Settings → Webhook:

• Click Create Webhook to configure Twilio delivery callbacks
• TatTool expects callback URL:
  • YOUR_PUBLIC_API_URL/webhook/twilio/<organizationId>/status
• If status shows mismatch, use Repair Webhook
• To disable callbacks, use Deactivate

Only owners/admins can manage webhook settings.

---

Self-Hosted Callback URL Resolution

Twilio webhook setup resolves callback base URL in this order:

1. TWILIO_WEBHOOK_BASE_URL (preferred)
2. WEBHOOK_BASE_URL
3. RESEND_WEBHOOK_BASE_URL
4. NEXT_PUBLIC_API_URL
5. APP_URL
6. NEXT_PUBLIC_APP_URL

Use a public HTTPS URL. Localhost/private network URLs cannot receive Twilio webhooks.