Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Livesearch
placeholderSearch the Vibes Developer Wiki
typepage



Overview

In an industry where each country has different technologies, carriers, and compliance around text messaging, it is important that you rely on a trusted partner like Vibes who have hands-on experience launching SMS campaigns in various countries and regions. Our existing contracts and long-standing relationships with multiple aggregators, means that we can provide the best support and responsiveness, 24 hours a day, 7 days a week. 

Table of Contents



Panel
borderColor#2B9CD7

Topics in this Section

Page Tree
root@self
startDepth2


Domestic Regions

U.S and Canada

  • To use the Vibes Connect Platform to send messages, you can connect to the U.S. and Canada endpoint endpoint https://messageapi.vibesapps.com/ for SMS and https://messageapi-mms.vibesapps.com for MMS Messaging.

  • Data is stored in Vibes U.S. data center

  • Mobile Number format used to send messages through the US endpoint: Include a plus sign (+) followed by the country code and number.

  • To use MMS in the U.S., please reference our MMS Message APIs (MM7) section. Vibes does not support MMS outside of the U.S.

International Regions

SMS Sender Options

Availability of SMS services varies by country. Depending on what carriers provide, Vibes can offer a choice between a short code, long code, or alpha code sender ID as well as a choice between one-way alerts and two-way interactive texting. Definitions of the sender options are below.

  • In-Country Short Codes – Typically five or six digits long, that enable SMS messages between brands and consumers. Limited to national borders, short codes must be activated in each country where the campaign will take place. Most in-country short codes are cross-carrier so you can reach all subscribers in a country, while some short codes are linked to a specific carrier. Short codes typically enable two-way texting, and their provisioning and monthly leases are higher and timelines to provision can be anywhere from 8 weeks to 14 weeks.

  • In-Country Long Codes – Ten to fourteen digits long (depending on the country), that enable SMS messages between brands and consumers. Long Codes enable both two-way texting and 1-Way messaging. In-Country Long Codes are often less expensive than in-country short codes and timelines to provision are usually shorter than Short Codes. Timelines to provision can be anywhere from 6 weeks to 10 weeks.

  • Alpha Codes – Allow you to set your brand name as the Sender ID (instead of a short code or long code) when sending one-way text messages. Alpha Codes do not accept inbound messages from consumers. Timeline to provision can be anywhere from 4 weeks to 6 weeks.

Europe and APAC

  • To use the Vibes Connect Platform to send messages to the EU and APAC, you will need to connect to a different endpoint than what is used to send messages to the U.S. and Canada. The endpoint to send messages to the EU and APAC is: https://messageapi-eu.vibesapps.com/MessageApi
  • Data is stored Vibes Ireland data center to be in compliance with GDPR

  • Mobile Number format used to send messages through the EU endpoint: Include a plus sign (+) followed by the country code and number.

  • Internationally we do not perform carrier lookup, MDNs are classified as UK_CARRIER, US_Carrier or International. All +1 MDNs are categorized as US_Carrier (502) in EU instance.

  • Reporting is accessed through Vibes Platform EU Analytics.

  • MMS is not supported outside of the U.S.

Mexico and Latin America (LATAM)

  • To use the Vibes Connect Platform to send messages to Mexico and LATAM, you can connect to the U.S. and Canada endpoint https://messageapi.vibesapps.com/

  • Data is stored in Vibes U.S. data centers

  • Mobile Number format used to send messages through the US endpoint: Include a plus sign (+) followed by the country code and number.

  • Internationally we do not perform carrier lookup, MDNs are classified as US_Carrier or International.

  • Reporting is accessed through Vibes Platform U.S. Analytics

  • MMS is not supported outside of the U.S.


Technical Implementation

Version History

For customers and developers, please check out the Version History topic for a review of the changes and additions to the Message API.

Paths

The format of all of the GET methods in this API are:

/MessageApi/<method>/<id>
or
/MessageApi/<method>/<id>?<variable>=<value>


The format of all of the POST methods in this API are:

/MessageApi/<method>Carrier Lookup Methods

Server Endpoints