Paramètre WEBHOOKS¶

Le paramètre définit une ou plusieurs adresses pour le traitement des webhooks entrants de Hotline pour une liste donnée d'événements.

Les webhooks sont envoyés en utilisant la méthode POST avec le corps de la requête au format JSON.

Types d'événements¶

1. Événements système¶

Valeurs disponibles : dialog_created, dialog_reopened, dialog_closed, message_received, message_sent, message_intercepted.

Les webhooks pour de tels événements ne retournent pas de résultats au groupe backend.

2. Commandes personnalisées¶

Toute commande personnalisée ou déjà existante du système peut être spécifiée. Le nom de la commande doit commencer par un slash /.

Les webhooks pour de tels événements peuvent retourner des résultats au groupe backend sous forme de message.

Pour plus de détails sur le format des requêtes envoyées, consultez la description du format des webhooks.

Par défaut, la liste est vide, les webhooks ne sont envoyés nulle part.

Format des données¶

La configuration des webhooks est définie au format JSON.

Pour effacer le paramètre, envoyez la valeur OFF

Il faut envoyer la valeur requise au bot de configuration après avoir sélectionné le paramètre à modifier.

Valeur par défaut¶

NONE

Exemples d'utilisation¶

{
  "https://someapiserver.com/webhooks/end_point-1": [
    "dialog_created",
    "dialog_reopened",
    "dialog_closed",
    "message_received",
    "message_sent",
    "message_intercepted"
  ],
  "https://someapiserver.com/webhooks/end_point-2": [
    "/mark", "/info",
    "/invoice", "/client"
  ]
}

Résultat : tous les événements système arriveront à end_point-1, et les événements concernant les commandes appelées iront à end_point-2.

Principaux cas d'usage¶

• intégrations externes
• analytique personnalisée