API SMS

Intégrez Primotexto à vos applications grâce à notre puissante API SMS.




  >  
Compte  >  

Principes

Le service Webhook vous permet de récupérer de façon automatisée l'ensemble des événements propres à l'émission de SMS.
Ainsi, vous pouvez recevoir toutes les mises à jour d'état de message: accusé de récéption, réponse au SMS, désinscription...
Il vous est possible de séléctionner les événements pour lesquels vous souhaitez recevoir automatiquement l'information.
Concrétement, le service de webhook communique via requêtes HTTP, encapsulant dans celles-ci l'information demandée.
Pour pouvoir recevoir le contenu de nos webhooks, il vous suffit d'avoir un service web en écoute d'information.

Configuration

Vous devez configurer le service depuis les paramètres de votre compte Primotexto pour pouvoir utiliser les WebHooks.
Les WebHooks vous permettent de récupérer sur l'URL de votre choix l'ensemble des événements liés à l'expedition de vos messages.

WebHooks Primotexto 1

Ajouter un WebHook

WebHooks Primotexto 2


Comportement du WebHook

Requête envoyée par le Webhook

URL

http://your.http.server/hook

HTTP METHOD

POST

Headers:

Content-type: application/json

DATA

{ "snapshotId": 37924260, "accountId": "5315a282e4b0656b1a95b114", "campaignId": "57d2bb266004e5621ee230de", "contact": { "id": "57d2bb366004e5621ee230df", "identifier": "+33695256192", "countryCode": 33 }, "replyMessage": "Contenu de la réponse !", "event": "reply", "eventDate": 1473429780000 }
Objets DATA
Description
"snapshotId"
Le numéro d'identification du message.
"accountId"
L'identifiant du compte qui a émis le message.
"campaignId"
La campagne de référence associée au message
"contact"
Les informations concernant le destinataire du message.
"contact.id"
Le numéro d'identification du contact.
"contact.attributes"
Les champs personnalisés du contact.
"contact.listId"
La liste de référence du contact.
"contact.identifier"
Le numéro de mobile du contact.
"contact.blacklisted"
L'état de blacklist du numéro.
"contact.invalid"
La validité du numéro.
"contact.international"
L'internationalisation du numéro.
"contact.countryCode"
L'indicatif pays du numéro.
"event"
Le nouvel état du message
"replyMessage"
Le contenu d'une réponse (si l'event est une réponse)
"eventDate"
La date de l'event (format millisecondes)