API REST et webhooks
Branchez WhatsApp à votre CRM, votre caisse ou votre logiciel
Une API REST simple, en JSON, pour envoyer des messages et des modèles validés, créer des contacts, répondre dans une conversation, lancer une campagne ou ajouter un rendez-vous ; et des webhooks signés pour recevoir chaque événement chez vous.
L'API et les webhooks font partie de l'offre Agence. Google Sheets et les boutiques se branchent sans code dans toutes les offres.
Démarrer en trois étapes
- 1
Créez une clé
Dans automatesend, Intégrations → API : la clé « as_live_… » s'affiche une seule fois. Gardez-la côté serveur.
- 2
Appelez l'API
En HTTPS et en JSON, avec l'en-tête Authorization: Bearer. Les numéros marocains sont acceptés tels quels (0661234567).
- 3
Recevez les événements
Ajoutez l'adresse de votre serveur et choisissez les événements : messages, commandes, rendez-vous, campagnes…
Exemples
Toutes les requêtes utilisent l'en-tête Authorization: Bearer as_live_... et du JSON.
Envoyer un modèle validé
curl -X POST https://automatesend.com/api/v1/messages \
-H "Authorization: Bearer as_live_..." \
-H "Content-Type: application/json" \
-d '{ "to": "0661234567", "template": "confirmation_commande",
"language": "fr", "variables": ["Salma", "#1024", "539 DH"] }'Répondre en texte libre (client ayant écrit il y a moins de 24 h)
curl -X POST https://automatesend.com/api/v1/messages \
-H "Authorization: Bearer as_live_..." -H "Content-Type: application/json" \
-d '{ "to": "0661234567", "text": "Votre colis part demain." }'Créer ou mettre à jour un contact
curl -X POST https://automatesend.com/api/v1/contacts \
-H "Authorization: Bearer as_live_..." -H "Content-Type: application/json" \
-d '{ "phone": "0661234567", "first_name": "Salma", "tags": ["VIP"] }'Points d'accès
https://automatesend.com/api/v1
POST/messagesEnvoyer un modèle validéGET/messages/IDstatut d'un message (sent, delivered, read, failed)POST/contactsCréer ou mettre à jour un contactGET/contacts?phone=0661234567chercher un contact (paginationlimit,cursor)GET/conversations?status=openlister les conversations (filtresstatus,needs_human,phone)GET/conversations/ID/messagesmessages d'une conversation, les plus récents d'abordPOST/conversations/ID/messagesrépondre en texte libre dans la conversation (moins de 24 h)POST/conversations/ID/templateenvoyer un modèle validé dans la conversationGET/campaignslister les campagnes avec leurs chiffresPOST/campaigns/ID/launchlancer tout de suite une campagne programmée, ou reprendre une campagne en pauseGET/analytics/overview?from=…&to=…vue d'ensemble : messages, taux de lecture, conversations, commandes, coût MetaGET · POST/appointmentslister ou ajouter des rendez-vous (le client reçoit le rappel)
Webhooks
automatesend envoie un POST JSON à votre adresse à chaque événement choisi.
message.receivedMessage reçu d'un clientmessage.sentMessage envoyé (équipe, assistant, automatisations, API)message.statusStatut d'un message envoyé (livré, lu, échec)contact.createdNouveau contactcontact.unsubscribedContact désabonnéconversation.openedConversation ouverte (nouvelle ou rouverte)conversation.closedConversation fermée par l'équipeconversation.handoffConversation transférée à l'équipe par l'assistantcampaign.launchedCampagne lancéecampaign.completedCampagne terminée (avec ses chiffres)order.createdCommande reçueorder.confirmedCommande confirmée par le clientorder.cancelledCommande annulée par le clientorder.reviewedAvis du client après livraisonlink.clickedClic sur un lien suiviappointment.bookedRendez-vous réservéappointment.rescheduledRendez-vous déplacéappointment.confirmedRendez-vous confirmé par le clientappointment.cancelledRendez-vous annuléform.submittedFormulaire WhatsApp rempli
Chaque webhook contient l'en-tête X-Automatesend-Signature: sha256=… : le HMAC-SHA256 du corps brut avec le secret du webhook. Comparez-le avant de traiter l'événement. En cas d'erreur (réponse différente de 2xx), l'envoi est retenté 3 fois.
Erreurs et limites
Chaque erreur renvoie un code HTTP et un objet { error: { code, message } }. 300 appels par minute et par clé.
- 401
- Clé absente, invalide ou révoquée.
- 404
- Contact, conversation, modèle ou message introuvable dans votre espace.
- 409
- Action impossible maintenant : fenêtre de 24 h fermée (utilisez un modèle), contact désabonné, créneau déjà pris…
- 429
- Trop d'appels : réessayez une minute plus tard.
Sans écrire de code
- Outils de l'assistant IAL'assistant appelle lui-même votre API pour lire un prix, un stock ou un statut, et prépare les actions que votre équipe valide.
- Google SheetsUne ligne par contact, commande ou rendez-vous dans votre feuille, avec un script fourni à coller.
- Boutiques et transporteursShopify, WooCommerce, YouCan, Sendit, Olivraison, Ozon : connexion par webhook, sans développement.

Prêt à brancher WhatsApp à vos outils ?
Créez votre compte, testez l'API avec le simulateur, puis connectez votre numéro.
