It is all about data nowadays. Especially with messaging, we want to understand what happened with our messages: like where they were delivered, or how much they cost. When sending a marketing campaign, for example, you need to know how much the messages cost in order to know the ROI of the campaign. 

Seeing this demand, MessageBird’s SMS API will now include information on the price per message and metadata like country and operators’ names for every SMS message you send with us. This should help improve the communications you send to your users and give you more insight around those messages. We will perform this change as a gradual rollout over the next two weeks. 

That means that you can get all the information you need without sending a message to our dear Customer Success team. You can also integrate that information into your own Business Intelligence tools for reporting purposes. Our hope is to enable as much autonomy and velocity on decision making for our customers as possible.

What’s the update? 

We’ve upgraded our SMS API to provide price information, currency, country and operator names, status reasons, and more on its response and in the report webhook URL. So, on top of the current information we share, the SMS API response will now provide fields like:

• Mottagarland: namn på det land som mottagarnumret tillhör

• Mottagarlandets prefix: internationellt landsnummer (t.ex. +31, +58, etc.)

• Mottagande operatör: MCCMNC-kod och namn på den nätoperatör som numret tillhör

• Meddelandelängd: antal tecken som meddelandet innehåller.

• Statusorsak: en skriftlig beskrivning av orsaken till meddelandets status. Till exempel, om det misslyckades, varför det misslyckades.

• Pris: Priset för det specifika meddelandet som det fakturerades med

• Valuta: den valuta som det specifika meddelandet fakturerades med

Vad är fördelen?

• Kostnad per meddelande - Tidigare behövde du kontrollera vår instrumentpanel för att få reda på den faktiska kostnaden för meddelanden. Nu får du den exakta kostnaden för SMS-meddelandena i realtid eller via statusrapporten. Du kan också integrera denna information i dina egna business intelligence-system.

• Descriptive Naming —  Now you will receive descriptive country and operator names, useful for your own reporting and BI processes, along with the pertinent MCCMNC codes.

• Character Count and Cost — Now, you can understand how many characters a message has and the related costs per message part. 

Hur ser det ut?

API-svaret kommer nu att innehålla denna nya information, se nedan under raden "statusDatetime":

Och reportURL kommer att se ut så här: