Compte et intégrations

Connecter un système externe ou un assistant

Créez une clé à accès limité avec Pro ou Agency, publiez du contenu inédit ou connectez un assistant.

Avant de commencer

Un webhook reçoit les notifications de messages entrants du service WhatsApp. Sa configuration sur le serveur relève de l’opérateur de l’intégration. Les utilisateurs du tableau de bord n’ont pas à modifier les paramètres du serveur. MCP permet à un assistant de demander des outils du compte.

Que faire

Pour les messages entrants, ouvrez Paramètres et repérez URL du webhook (pour le serveur WhatsApp).
Choisissez Copier pour obtenir l’adresse exacte du déploiement de votre compte.
Demandez à l’opérateur de configurer les événements entrants de l’appareil voulu avec cette adresse.
Prévoyez un message entrant de test depuis votre propre numéro lorsque l’opérateur confirme que tout est prêt.
Vérifiez le résultat attendu, par exemple une réponse automatique correspondante ou un nouveau message de groupe enregistré lorsque Journal est activé.
Pour connecter un assistant, connectez-vous via l’écran d’autorisation ouvert par votre client MCP.
Vérifiez l’application nommée et le compte avant d’autoriser l’accès.
Pour intégrer les envois, ouvrez Paramètres → Intégrations externes. Créez une clé nommée pour un compte connecté et des groupes explicitement sélectionnés. Enregistrez la clé immédiatement ; elle ne s’affiche qu’une seule fois. Copiez l’URL de base de l’API.
Exemple : Configurez Abacus.AI pour générer du contenu inédit à chacun des huit horaires de publication quotidiens dans le fuseau horaire America/Sao_Paulo. Soumettez chaque publication à trois groupes autorisés avec un nouvel Idempotency-Key. Réutilisez cette clé uniquement pour réessayer une demande identique.
Omettez scheduled_at pour une mise en file immédiate, ou utilisez un horodatage absolu avec -03:00 ou Z (UTC), au maximum 30 jours à l’avance. Le traitement vérifie la file chaque minute ; scheduled_at désigne le premier instant admissible, sans garantie de livraison à la seconde près.
Vérifiez l’état de la publication et les résultats par groupe avant de réessayer. Annulez uniquement les envois pas encore lancés. Révoquez une clé compromise dans Paramètres, puis créez et enregistrez sa remplaçante ; les anciennes publications ne reprennent pas avec une nouvelle clé.

Exemple pratique

Demandes avec des valeurs fictives ; remplacez les identifiants et choisissez une date future avant l’envoi. Ces demandes publient de vrais messages. curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'

Vérifier le résultat

L’acceptation de la publication et les résultats acceptés par groupe confirment l’acceptation par la passerelle. Ils ne confirment ni la livraison ni la lecture. Les tâches programmées peuvent être bloquées si l’accès, la clé, le compte ou les autorisations des groupes changent.

À savoir

Les assistants peuvent lire les données exposées et envoyer du texte sur demande. Consultez le guide des outils d’assistant avant de demander un envoi.
Utilisez le tableau de bord pour les modifications indisponibles via MCP.
L’accès à l’API est inclus dans les abonnements Pro et Agency mensuels ou annuels. Starter nécessite un changement d’offre. Les clés autorisent uniquement le compte et les groupes sélectionnés ; remplacer le compte WhatsApp bloque les envois. Ne partagez jamais les identifiants du serveur.
Les textes acceptent 4 096 caractères ; les légendes, 1 024. Importez des fichiers JPEG, PNG ou WebP de 5 MiB maximum dans les champs multipart payload et image. Les URL d’images distantes ne sont pas acceptées.
Une nouvelle publication renvoie HTTP 202. Une demande identique répétée avec le même Idempotency-Key renvoie la publication initiale avec HTTP 200 ; un contenu différent avec la même clé renvoie 409. Un délai dépassé après le lancement de l’envoi peut laisser son résultat non confirmé ; ne le soumettez pas automatiquement avec une autre clé.

Problèmes courants

Ce que vous voyez: Aucune réponse ou nouvelle entrée n’apparaît après le test.
Que faire: Vérifiez la connexion de l’appareil et la règle ou le paramètre Journal concerné, puis demandez à l’opérateur de vérifier la configuration des événements entrants.
Résultat attendu: Une fonctionnalité correctement configurée peut traiter un nouvel événement correspondant.

Ce que vous voyez: L’assistant ne peut pas obtenir l’autorisation ou affiche un autre compte.
Que faire: Revenez à la connexion et sélectionnez le bon compte ; signalez à l’opérateur les erreurs d’autorisation répétées.
Résultat attendu: L’écran d’autorisation et les données renvoyées appartiennent au compte voulu.

Obtenir de l’aide

Indiquez à l’opérateur la fonctionnalité et l’erreur affichée. Ne communiquez pas d’identifiants de serveur dans les conversations avec les assistants.

Ouvrir cette fonction