Guide/SendApp Agent/Rapports et API

Clés API et webhooks

Si vous voulez intégrer SendApp Agent à vos systèmes (logiciel de gestion, CRM, automatisations), l’API est la voie à suivre. Vous trouvez ici comment vous authentifier, ce que vous pouvez faire et comment recevoir les événements entrants via webhook. C’est un guide technique, mais avec les concepts expliqués pas à pas.

Mis à jour le 16 juin 2026 · 6 min de lecture

Obtenir la clé API

1. 1

   Ouvrez la section « API »

   Dans le menu, ouvrez API : c’est ici que vous trouvez la clé développeur (apikey) de votre compte.

2. 2

   Copiez la clé

   Utilisez-la pour authentifier vos requêtes. Traitez-la comme un mot de passe.

Comment s’authentifier

URL de base

L’API est sur le domaine de votre compte, avec le préfixe /api (ex. https://votre-domaine/api). N’utilisez ni « /v1 » ni des domaines différents.

Authentification

Passez la clé dans l’en-tête HTTP « X-API-Key », ou comme paramètre « apikey » dans la requête. Le bearer token ne s’utilise pas.

Ne partagez pas la clé API et ne l’insérez pas dans du code public (ex. JavaScript côté navigateur) : quiconque détient la clé peut agir sur votre compte. Si elle est exposée, régénérez-la.

Ce que vous pouvez faire via l’API

• Envoyer des messages (ex. via l’endpoint d’envoi WhatsApp), dans les limites des règles du canal (sur l’API officielle Meta, pour écrire en premier il faut un template approuvé).
• Gérer les contacts du carnet d’adresses.
• Créer un nouveau Compte (bot) de façon programmatique.
• Enregistrer l’URL de votre webhook pour recevoir les événements entrants.

Les endpoints qui acceptent la clé fonctionnent aussi bien avec le compte titulaire qu’avec un opérateur habilité : attribuez les clés avec discernement selon qui doit intégrer.

Webhooks : recevoir les événements

Avec les webhooks, vous recevez en temps réel les événements entrants (ex. un nouveau message depuis un canal). Vous enregistrez l’URL de votre endpoint via l’API : à partir de ce moment, SendApp envoie les données à votre système lorsque l’événement se produit. C’est le moyen de tenir aligné un CRM ou un logiciel de gestion externe.

Erreurs courantes

401 / non autorisé

Clé manquante ou erronée : vérifiez l’en-tête X-API-Key ou le paramètre apikey.

URL erronée

Utilisez le domaine de votre compte avec le préfixe /api, sans « /v1 ».

Trop de requêtes sur un endpoint

Certains endpoints ont une limite de fréquence : répartissez les appels au lieu de les concentrer.