Comment ajouter un webhook

Mis à jour le

Dans SyBox, cela se fait dans Paramètres > Intégrations > Webhooks.

  1. Allez dans Paramètres > Intégrations > Webhooks.
    Settings, Webhooks: an active webhook with its last result, and the "Add webhook" button
  2. Cliquez sur "Ajouter un webhook".
    The new webhook window: its name and the address it calls
  3. Renseignez un "Nom".
  4. Saisissez l'"URL de destination". Elle doit correspondre à "Une adresse https publique que nous pouvons joindre". Les adresses HTTP simples ainsi que les adresses réseau privées ou internes sont rejetées.
  5. Sous "Événements", activez au moins un type d'événement. "Message entrant" est coché par défaut.
  6. Facultatif : activez "Transcription vocale" pour recevoir les messages vocaux accompagnés de leur texte.
  7. Sous "Numéros", conservez "Tous les numéros" actif pour couvrir l'ensemble des lignes WhatsApp. Ou désactivez-le pour ne cocher que les numéros souhaités.
  8. Cliquez sur Enregistrer.
  9. Une fenêtre affiche la "Clé de signature". "Copiez-la maintenant — elle ne sera plus affichée." Enregistrez-la sur votre serveur.

Questions

J'ai perdu ma clé de signature.

Elle ne peut plus être réaffichée. Modifiez le webhook, saisissez une nouvelle clé de votre choix dans "Clé de signature", enregistrez, puis appliquez cette nouvelle clé sur votre serveur.

Mon webhook a été désactivé alors que je n'ai rien fait.

SyBox l'a désactivé après 20 échecs d'affilée de votre serveur pendant plus d'une heure. Voir "Désactivé automatiquement" ci-dessus : réparez votre serveur, puis réactivez le webhook dans les 24 heures afin que les événements en attente soient envoyés.

Mon webhook ne reçoit jamais rien.

Cliquez d'abord sur "Envoyer un événement de test" sur sa carte et consultez "Livraisons". Contrôlez ensuite ces quatre éléments. (1) Le webhook est bien activé. (2) Au moins un événement est sélectionné. (3) Il couvre le bon numéro WhatsApp ou "Tous les numéros". (4) Le canal sur lequel le message est arrivé est pris en charge par les webhooks (WhatsApp, Messenger, Instagram, Telegram, TikTok ou Chat en direct ; pas les e-mails ni les SMS). Consultez ensuite le statut du dernier envoi sur la carte.

La carte affiche une erreur rouge comme HTTP 404 ou 500.

SyBox a réussi à joindre votre adresse, mais votre serveur a renvoyé une erreur. Contrôlez l'URL ainsi que les journaux de votre serveur.

Impossible de créer un webhook, un message indique que je n'y suis pas autorisé.

Créer un webhook ou en réactiver un requiert à la fois la permission "Gérer les canaux" et "Afficher le numéro du contact". Rapprochez-vous de votre administrateur.

En savoir plus sur Webhooks.