What would you like to know more about?

Add a Webhook for Inbound Messages

Using a webhook, you can display inbound texts from your Twilio account in the Platform.

  • You must have a configured Twilio account. Fees apply for inbound messages.
Note: Already have a Twilio account and want help configuring the webhook? Contact Support for assistance!

From your Twilio account, you can configure a messaging webhook for each active phone number. This optional feature is only for informational purposes. You can see replies from text messages the Platform sent, but you can't respond to their reply. It is not a two-way texting feature.

This webhook also allows the Platform to automatically update the Do Not Text field on Contact records when they opt out or opt in by replying to a message.

  1. Log in to your Twilio account.
  2. Under Phone Numbers, click the Manage Numbers tab.
  3. Under Active Numbers, select the number.
  4. In the Messaging section, set the following:
    1. Set Configure With to Webhooks....
    2. For A Message Comes In, select Webhook.
    3. Enter the webhook formula, which is your MinistryPlatform Base URL + /ministryplatformapi/callback/twilio/ + your SMS Server Callback Secret GUID (from your Domain record).
      https://{your platform domain}/ministryplatformapi/callback/twilio/a1b234cd-e567-8f90-1gh2-34ijklmn5o67
    4. In the last drop-down list, select HTTP POST.

    Twilio interface showing the Messaging section with the Webhook selected

When you receive an inbound text, it creates a record under Communications > Inbound Messages. The record includes:
  • Time received
  • Message To number
  • Message From number
  • Message Text, up to 1,600 characters – the Twilio limit
  • Emojis are accepted (but do affect cost)
  • Images and GIFs (these display as files attached to the Inbound Message record)
    Note: You can receive images with or without text.
thumb_upYes thumb_downNo