Skip to main content

Integrating the Provider

To integrate MessageMedia with Courier head to the integrations page and select the MessageMedia provider to configure. In the MessageMedia console:
  • Create new key
  • Copy the API key and secret (Make sure you save the api_secret as you will not be able to see it again)
  • Copy the credentials and paste them into Courier’s integration page

MessageMedia API Key

Profile Requirements

To deliver a message to a recipient via MessageMedia, Courier must be provided the recipient’s SMS-compatible telephone number. This value should be included in the recipient profile as phone_number.
{
  "message": {
    // Recipient Profile
    "to": {
      "phone_number": "+491575556511"
    }
  }
}

Message Status Webhooks

After integrating MessageMedia into Courier, you will have access to a unique webhook URL that you can integrate with MessageMedia webhooks to receive delivery updates that sync to Courier’s Message Logs. To configure webhooks, navigate to the MessageMedia integration and copy the unique webhook URL. With the webhook URL in hand, follow these steps to configure in MessageMedia’s console:
  • Select New Webhook
  • In the webhook configuration menu, paste Courier’s webhook URL
  • Under Event select Message is rejected, Message has failed, Message is delivered under Delivery reports

MessageMedia Webhook Configuration

  • Under Content, map the content to be passed in the content of the request to Courier’s webhook endpoint.
Only messageId, receivedTimetamp, status, and statusCode are supported.

Webhook Content Mapping

Courier will now receive delivery updates visible in the message logs.

Delivery Confirmation