Développeurs · API

Automatisez vos envois vocaux par HTTP.

Envoyez ou déposez un message vocal via une simple requête HTTP, en direct ou programmée, depuis votre CRM, PGI/ERP ou vos scripts.

Point d'entrée

https://www.123-vocal.net/http.php?email=&pass=&numero=&ref=&transfert=&com=&emetteur=&diff=

Sécurité : effectuez toujours vos requêtes en HTTPS et ne diffusez jamais vos identifiants. Le message doit être enregistré au préalable dans votre espace client (rubrique « Messages enregistrés ») pour obtenir sa ref.

Paramètres requis

Paramètre	Description
`email`	Adresse e-mail saisie lors de votre inscription.
`pass`	Votre mot de passe.
`numero`	Numéro du destinataire, sans espace.
`ref`	Référence du message (numéro indiqué dans « Messages enregistrés »).
`emetteur`	Numéro de l'émetteur (à faire déclarer au préalable auprès de notre service commercial).

Paramètres optionnels

Paramètre	Description
`transfert`	Numéro de transfert lorsque le destinataire tape la touche 9.
`com`	Commentaire, uniquement destiné à retrouver vos différents envois.
`diff`	Jour et heure d'un envoi différé (voir ci-dessous).

Envoi en différé

Programmez l'envoi au jour et à l'heure de votre choix en ajoutant le paramètre diff au format heure_minute_jour_mois_an (sans espaces).

# Envoi le 12 septembre 2027 à 15h30 &diff=153012092027 # Supprimer un envoi différé : ajouter « s » après la date &diff=153012092027s

Exemple complet

GET https://www.123-vocal.net/http.php?email=vous@societe.fr&pass=••••••&numero=0612345678&ref=125&emetteur=0170719904&com=campagne-mars

Codes retour

À chaque envoi, une valeur vous indique l'état de la requête :

Code	Signification
`80`	Le message a été envoyé.
`81`	Le message est enregistré pour un envoi en différé.
`82`	Le login et/ou le mot de passe n'est pas valide.
`83`	Vous devez créditer le compte.
`84`	Le numéro n'est pas valide.
`85`	Le format d'envoi en différé n'est pas valide.
`86`	Le groupe de contacts est vide.
`87`	La valeur `email` est vide.
`88`	La valeur `pass` est vide.
`89`	La valeur `numero` est vide.
`90`	La valeur `ref` est vide.
`91`	La référence n'est pas valide.
`92`	Vous avez déjà envoyé ce message.
`93`	La valeur `emetteur` est vide.

Rappel de conformité : avant tout envoi, assurez-vous de disposer du consentement préalable des destinataires (base opt-in) et d'un numéro émetteur conforme. Voir notre page Conformité & réglementation.