Support

FAQ

What can I do with these APIs?

You can send text messages with as much text as you want, you can send images, share pictures, videos, send songs and other audio clips, you can run contests and receive entries from people via mobile phones, you can deliver app download links, you can send delivery notifications, friend requests....the limit is your imagination!

What does it cost?

There is no cost at all to try it out, $25 worth of credits for free. After that, if you want to continue to send messages or use the other APIs, you can set up credit card billing and we will charge you only for the API calls you use. SMS and MMS are only one cent each, the other APIs have pricing posted in the pricing section.

What are carrier pass-through costs?

Some carriers have an additional charge for messages that pass through their networks. Unfortunately we are forced to pass along those costs. However, we pass these costs on directly, with no markup on our end. The pass-through costs are listed below.
These pass-through fees will take affect starting on February 1, 2014.
If you would like to shut off support for a specific carrier(s) on your account, let us know and we would be happy to help you with that. You always have the option to turn support back on if you choose to do so.

Incoming Outgoing
Boost SMS: 0.5¢ 0.5¢
Metro PCS SMS: 0.75¢ 0.75¢
Sprint SMS: 0.5¢ 0.5¢
Sprint Non-Video MMS: 2.5¢ 2.5¢
Sprint Video MMS: 10.0¢ 10.0¢
Virgin SMS: 0.5¢ 0.5¢
T-Mobile SMS: 0.25¢ 0.25¢
T-Mobile MMS: 1.0¢ 1.0¢
Cricket SMS: 0.25¢ 0.25¢
Cricket MMS: 0.25¢ 0.25¢
US Cellular SMS: 0.35¢ 0.35¢
US Cellular MMS: 0.35¢ 0.35¢
How do I get started?

Just sign up for an account and start making API calls. No credit card or other billing is required to set up an account. You can sign up, receive the client id and auth token and be sending SMS and MMS in 10 minutes or less.

What countries are supported?

Currently only the U.S. is supported. Adding support in Canada and the UK would be easy, so if that is of interest to you, please send us a request!

What carriers are supported?

SMS is supported on all carriers in the U.S. MMS is supported on all the top carriers: AT&T, Verizon, Sprint, T-Mobile, Cricket, Alltel, and US Cellular as of 8/2012.

What happens if I send to a Google voice number or land line?

What happens if I send to a Google voice number or land line? The message will not be delivered! We can't complete delivery to Google voice numbers, and land lines don't have message in boxes. Sorry. This service is all about delivering content to Mobile devices like cell phones, tablets, etc.

What is the character limit for MMS?

There is NO CHARACTER LIMIT for MMS. That's one of the great things about it! If you have a long (500 character) message, rather than send three SMS, you can send it all in a single MMS - saving money and providing a better user experience! The actual limit for MMS is data size. You can send at least 250,000 characters on all carriers via MMS.

What happens if I send MMS to a carrier that only supports SMS?

Our platform will detect that the carrier does not support MMS, and will instead send an SMS with a link to view the content in a browser on the target device!

What if I send video to a handset that can't play video?

Our platform will detect that the device does not support video, and we will send a 'legacy' message to the phone with a URL the user can copy and paste into a PC browser to view the content.

I sent a video as MMS, but it arrived as SMS with a link to view the video in a browser. Why?

If the carrier and handset support video, then the most likely reason is that the video was too long (to large in bytes) to be delivered. The max byte size for delivery varies between carriers, but in general if you keep the video below 50 seconds long you should be safe. To debug the issue, send a small (short) video (or image) and see if the delivery goes through as an MMS. In rare cases a carrier may be having difficulty with their MMS delivery systems, and when that happens we try to deliver the message as SMS with a link until the problems are resolved.

Does the recipient have to opt-in to receive these SMS and MMS messages?

Yes, all sends are permission based. If the user has not received content from the shortcode before, a first message will be sent asking them to reply Y to receive the message. Once our system does receive the Y from that user MSISDN, the send will continue and the content will be delivered. The user must only reply Y once. The Mogreet system will also allow the user to opt-out by sending 'stop' to the same shortcode.

Does this cost anything for the recipient?

Does this cost anything for the recipient?

The SMS and MMS messages are generally included as a part of the text messaging bundle included in the recipients phone service. If the recipient does not have a messaging plan or bundle, the SMS and MMS messages might be charged individually - that part is up to the carrier. Generally the language 'message and data rates may apply' is required (by the carriers) to be included in the messages, so that the recipient is alerted to the possibility of a charge. The vast majority of subscribers in the US have a text messaging plan, and so have no specific charge for message delivery. MMS do not count against the data plan, either, so there should be no charge for data usage when receiving MMS messages.

What are the supported media types for MMS message delivery?

We support .jpg for images, .mp3, .aif, .wav and others for audio, and for video we support .mov, .avi, .mp4, .3gp and others. A complete list is in the documentation.

The video looks fantastic on some carriers, and not so good on others. Why is that?

We transcode many different versions of the content and use the best one for the target carrier and device. Some carriers have lower data limits, so we need to use smaller versions. Some devices have lower screen resolution, or only support older codecs, or have other limitations that all affect quality. Some carriers will even try to intercept and re-transcode the content before it is delivered to the device! In general the best quality will be found on smart phones on At&T and Verizon, then T-Mobile, and finally Sprint, which has the lowest file size limits.

Why am I getting back a '403 forbidden' response to my API call?

That error indicates that there is a security violation of some kind. It is the most common error experienced, and internally at Mogreet we found that we all saw that error while implementing the APIs. So you are not alone. Here are the top causes and how to fix them!

  1. Trying to access the API over HTTP, not HTTPS. Solution: use HTTPS! The APIs require a secure connection.
  2. Wrong Client Id. Verify that you are passing your own your client ID - make sure you didn't accidentally copy one from an example snippet.
  3. Wrong Auth token. Verify that you have entered the token correctly, or just re-copy and paste it. Make sure there are no extra spaces before or after!
  4. You are testing using cURL, but did not 'quote' the API call string. When using cURL on a command line, the ampersands (&) in the API call look to the command line interpreter like breaks between commands. So it issues the API string with the params up to the first&, which usually means your client id is included, but your token is not. No token = 403 forbidden.
  5. There is an IP white listing problem. By default, all IPs are white listed, but it might be that you have requested that we limit IP access to a specific range. And either we got that wrong (sorry) or maybe you are sending the API call from a different IP range, like from home for testing rather than from production. Or the production IPs changed. It happens. Solution: verify IPS, and email support@mogreet.com to update them.
Can I get the API response in JSON instead of XML?

Yes! we are rolling out JSON on all the API calls. try adding 'format=json' to your call and see what comes back.

Can I customize the number the message comes from? Does it have to be a shortcode?

Sorry. The message must appear to come from the originating shortcode.

Are there throttle limits or other service limits I should know about?

We do not limit the total sends you can make, but we do limit them to 3 per second, and 10 per recipient per day. This helps us reserve enough throughput for everyone!

I made a transaction.send API call to send an MMS to Verizon. Before the message arrived, a message titled 'checking your handset' arrived. What is that?

On some carriers, when we have not detected the recipient handset or device previously, we send a 'handset detection MMS' first, before we deliver the content. This special MMS returns the device info to us, so we can choose the best version of the content for playback on that specific device. Your recipients should rarely see the message. The body of the message reads: 'this message is checking your handsets media capabilities...'

A send did not go through. The API call was a success, but no message arrived at the phone... :-( Why not?

There are several possibilities. If the content sent was included as a URL, but the transcoder could either not reach that content at the URL (maybe it required a login) or the content was not of a supported type (like a power point presentation) then the transcode will fail and no content will be delivered. It is also possible that the carriers are experiencing message delays, and the content will arrive soon.

What is the max length for a Video MMS message?

There is no maximum length, only a maximum delivery file size. Since we control the transcoding of the delivery file, we make every effort to adaptively transcode the content into a series of files so that we have the right size to deliver in all cases. However, in cases where the video is just way too long, we cannot compress it to achieve delivery and still be worth viewing. We suggest keeping video under 50 seconds in length for MMS delivery.

What is this 'Campaign Manager' thing I keep reading about?

Mogreet serves enterprise customers as well as developers. These customers have account managers to help them, and access to a web GUI to run campaigns. That web GUI is called the 'Campaign Manager'.

How does the Callback parameter work?

There are events, like sending errors or problems transcoding, or just receiving in a text message from a mobile user, that occur on their own time schedule (asynchronously). The Callback is a way to communicate those events to the developer. You provide a callback URL with the API call (or for MOs, when you sign up) and then when these events occur, an XML body containing information regarding the event is delivered, via HTTP, to the URL you provided.

How do I receive MOs? How can I get the message a user texts back to my keyword?

You can set up your MO callback URL through your developer dashboard settings. Then when someone texts in to your keyword on the shared shortcode, the Mogreet platform will fire off an XML callback over HTTP to that URL you provided, containing the user MSISDN, the message they sent and other pertinent information.

How can I receive delivery reports, transcode errors, delivery errors, etc, to have more visibility into the delivery process?

See the callback, above!

Is the credit card billing process safe and secure?

Yes. Mogreet uses Stripe online credit card processing service. We do not store any credit card or PII data ourselves. All credit card and billing transactions are transmitted securely.

What is the billing cycle for this service?

Bills are created on the first day of the month, covering all the message volume during the previous month. For example, if you sign up on June 6th, your bill will be calculated on July 1st, for all of June.

Can I use Paypal, Bitcoin or small chips of gold?

Nope! We do accept chickens, though. oops - just kidding! Major Credit Cards only please.

What legal and regulatory things do I need to worry about?

Organizations and regulations that oversee compliance in the text messaging industry are TCPA, Mobile Marketing Association (MMA), and CTIA.

What is the TCPA?

What is the TCPA? The Telephone Consumer Protection Act was passed in 1991. Although originally intended to prevent “robo-calls,” courts have extended it to cover delivery of text (SMS/MMS) messages. The key elements are that you need the recipient’s “express consent” in order to “make a call” (or send a text message) to any mobile number using an automated system. Recent supplemental regulations and court rulings have made it very clear that in order to stay out of trouble, commercial senders need the recipient’s express written consent before sending them a text. “Written” can mean a submission via a web form or an opt-in via a SMS/MMS message (for instance, “text JOINME to 12345.” This is an evolving area and different courts in different parts of the country have ruled in different ways even when they were faced with similar fact patterns. TCPA can also cover instances where senders didn’t do what they said: they told people they’d only receive news updates, then sent ads, or said they’d send one message a week and then send five.

What is the MMA?

The Mobile Marketing Association (MMA) is the premier global non-profit trade association representing all players in the mobile marketing value chain. With more than 700 member companies, the MMA is an action-oriented organization with global focus, regional actions and local relevance. The MMA's primary focus is to establish mobile as an indispensable part of the marketing mix. The MMA works to promote, educate, measure, guide and protect the mobile marketing industry worldwide. The MMA's global headquarters are located in the United States and it has regional chapters including North America (NA), Europe, Middle East and Africa (EMEA), Latin America (LATAM), and Asia Pacific (APAC) branches. For more information, please visit www.mmaglobal.com.

What is CTIA?

CTIA-The Wireless Association® is an international nonprofit membership organization that has represented the wireless communications industry since 1984. Membership in the association includes wireless carriers and their suppliers, as well as providers and manufacturers of wireless data services and products. The association advocates on behalf of its members at all levels of government. CTIA also coordinates the industry's voluntary efforts to provide consumers with a variety of choices and information regarding their wireless products and services. This includes the voluntary industry guidelines; programs that promote mobile device recycling and reusing; and wireless accessibility for individuals with disabilities. (Source: CTIA.org)

What do I have to do to TCPA, MMA and CTIA compliant?
  • Be respectful: Content providers must always be cognizant of the number of messages they are sending to participants in their programs to avoid a poor user experience.
  • Be compliant: When promoting programs, content providers should ensure that all forms of advertising includes clear and conspicuous terms and conditions associated with offers and adheres to all state and federal regulations.
  • Be careful: Use of the word “free” varies by carrier. However, when there are no fees or charges other than standard messaging and data charges, synonyms (i.e. complimentary, promotional, no charge) are supported by all carriers and must be used with the phrase “Msg & Data Rates may apply”.
  • Include Language: “Msg&Data Rates May Apply” should be added at the lower third of the commercial or advertisement when “free” appears in the audio or visual.
  • Be clear: The verbiage around the placement of “Msg&Data Rates May Apply” should be clear and conspicuous on the call to action/promotion/advertising and should NOT be deceptive in any nature nor lead to an indirect subscription of services. Illegible font sizes or presentment (including scrolling or moving graphics) and obscuring of the disclaimer “Msg&Data Rates May Apply” are prohibited.
  • Get it in “writing:” collect the recipient consent in a web form, database table, or other permanent storage.
  • Do only what you say: If you say you’re only going to send updates when their team scores, don’t send ads and don’t send other messages.
  • Learn more: For more specific best practices download the MMA Best Practice Guide
What happens if I do not follow compliance regulations?

TCPA regulations can be enforced in at least three different ways:

  1. The individual who receives a call after a name removal request has been given to the caller is granted a private right of action in a local court and may sue for $500 in damages for each violation. In some cases, the courts can levy triple damages for willful violations. Similar suits may be filed for violations of the TCPA's provisions regarding faxes, autodialers, and artificial or prerecorded messages.
  2. States may initiate civil action against offending companies on behalf of their citizens.
  3. Complaints may be filed with the Federal Communications Commission, which has the power to assess penalties against parties in violation of the TCPA.
  4. Any account discovered not to be compliant will be immediately suspended by Mogreet and any acquired costs with non-compliance will be charged to your account. Please refer to the Mogreet terms and conditions page for additional information.