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. 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. 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. 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 contact
  • GET/contacts?phone=0661234567chercher un contact (pagination limit, cursor)
  • GET/conversations?status=openlister les conversations (filtres status, needs_human, phone)
  • GET/conversations/ID/messagesmessages d'une conversation, les plus récents d'abord
  • POST/conversations/ID/messagesrépondre en texte libre dans la conversation (moins de 24 h)
  • POST/conversations/ID/templateenvoyer un modèle validé dans la conversation
  • GET/campaignslister les campagnes avec leurs chiffres
  • POST/campaigns/ID/launchlancer tout de suite une campagne programmée, ou reprendre une campagne en pause
  • GET/analytics/overview?from=…&to=…vue d'ensemble : messages, taux de lecture, conversations, commandes, coût Meta
  • GET · 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 client
  • message.sentMessage envoyé (équipe, assistant, automatisations, API)
  • message.statusStatut d'un message envoyé (livré, lu, échec)
  • contact.createdNouveau contact
  • contact.unsubscribedContact désabonné
  • conversation.openedConversation ouverte (nouvelle ou rouverte)
  • conversation.closedConversation fermée par l'équipe
  • conversation.handoffConversation transférée à l'équipe par l'assistant
  • campaign.launchedCampagne lancée
  • campaign.completedCampagne terminée (avec ses chiffres)
  • order.createdCommande reçue
  • order.confirmedCommande confirmée par le client
  • order.cancelledCommande annulée par le client
  • order.reviewedAvis du client après livraison
  • link.clickedClic sur un lien suivi
  • appointment.bookedRendez-vous réservé
  • appointment.rescheduledRendez-vous déplacé
  • appointment.confirmedRendez-vous confirmé par le client
  • appointment.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.