Twilio Integration

Automatically send an SMS text message whenever a form is submitted — useful for notifying your team instantly, or confirming receipt with the submitter. Twilio requires Contactum Pro with the Twilio module enabled.

---

Requirements #

• Contactum Pro, with the Twilio module active (Contactum → Modules)
• An active Twilio account — sign up here if you don’t have one
• Either a Twilio phone number or a Messaging Service SID

---

1. Get Your Twilio Credentials #

1. Log in to the Twilio Console.
2. Copy your Account SID and Auth Token from the dashboard.
3. Note either a Twilio phone number (in E.164 format, e.g. +15551234567) you want to send from, or a Messaging Service SID if you use one.

---

2. Connect Twilio in Contactum #

1. Go to Contactum → Settings → Integrations → Twilio.
2. Paste in your Account SID and Auth Token.
3. Fill in either a From Number (E.164 format) or a Messaging Service SID. If both are set, the Messaging Service SID takes priority and the From Number is ignored.
4. Click Verify Connection.

Contactum confirms your Account SID/Auth Token pair against Twilio before saving. On success you’ll see “Your Twilio connection has been verified and saved” and the status badge turns green.

To disconnect, click Disconnect Twilio — this clears the stored credentials and stops all SMS sending until reconnected.

---

3. Enable Twilio on a Specific Form #

1. Open the form in the builder.
2. Go to Form Settings → Integrations.
3. Toggle Twilio SMS on, then click Configure.

---

4. Configure the Message #

Field	Required	Description
To Number	Yes	The recipient’s phone number, in E.164 format. Usually mapped from a Phone field using a smart tag, e.g. {field:phone}
Message	Yes	The SMS text to send, e.g. Hi {field:name}, thanks for your submission!

Note the smart tag format: Twilio (and several other Pro integrations) use {field:field_name} — with the field: prefix — rather than the plain {field_name} shorthand used elsewhere in Contactum. Use the { } button under each field to insert the correct tag automatically.

---

5. How It Works #

When a visitor submits the form:

1. Contactum checks the form has Twilio enabled and both To Number and Message are configured.
2. The smart tags in both fields are resolved against the submission. If either resolves to an empty value, no SMS is sent — this is expected behavior, not an error.
3. Contactum sends the message via Twilio, using your Messaging Service SID if one is set, otherwise your From Number.

A failed SMS does not block the form submission — the visitor still sees a normal success confirmation. Failures are recorded in Contactum’s API Log and can be retried from there.

---

Troubleshooting #

“Your Twilio connection could not be verified” #

• Reconfirm the Account SID and Auth Token were copied exactly from the Twilio Console.

SMS isn’t sending #

1. Confirm the form has Twilio toggled on and was saved.
2. Confirm both To Number and Message are mapped — the integration silently skips sending if either resolves empty.
3. Confirm the To Number field actually contains a valid E.164-format number (e.g. +15551234567) — Contactum doesn’t reformat or validate phone numbers before sending, so a malformed number will fail at Twilio’s end.
4. Check the API Log for a logged failure and its error message.

My From Number isn’t being used #

• If a Messaging Service SID is also set globally, it always takes priority over the From Number. Clear the Messaging Service SID if you want to send from a specific number instead.

---

Notes #

• Requires Contactum Pro with the Twilio module active — not available in the free plugin.
• Auth method: Account SID + Auth Token (HTTP Basic Auth) — not OAuth.
• API version: Twilio REST API 2010-04-01.
• Credentials storage: all fields are stored in wp_options under the key contactum_twilio.
• A failed submission never blocks the form — the visitor’s experience is unaffected by a Twilio outage or misconfiguration.