Les webhooks constituent un pont technique entre Kanal et vos outils quotidiens. Ils vous permettent de recevoir une notification automatique en temps réel dès qu'un nouveau message arrive sur votre compte Kanal. C'est l'outil idéal pour les équipes qui souhaitent centraliser leurs alertes sur Slack, Discord ou déclencher des flux de travail personnalisés via des plateformes d'automatisation.
Un webhook est une méthode de communication automatique. Au lieu que vous ne deviez vérifier manuellement si vous avez reçu une réponse sur WhatsApp, Kanal "pousse" l'information vers une URL spécifique que vous aurez configurée.
Cette fonctionnalité est particulièrement puissante pour :
Alerter une équipe de support sur un canal Slack.
Créer un ticket automatiquement dans un CRM externe.
Notifier un gestionnaire de compte sur son téléphone via des applications tierces.
Pour vous simplifier la vie, notre application mobile native Kanal arrive très prochainement. Elle vous permettra de recevoir toutes vos notifications directement sur votre téléphone sous forme de notifications "Push", sans aucune configuration complexe de webhook.
Si vous souhaitez faire partie des premiers testeurs et accéder à la version bêta, n'hésitez pas à nous envoyer un message via le support.
Lorsqu'un message entrant est détecté, Kanal envoie une requête HTTP de type POST vers l'URL du webhook que vous avez renseignée dans vos paramètres. Les informations sont transmises au format JSON.
Voici la structure des données que vous recevrez :
{
"title": "Nouveau message sur Kanal",
"body": "{{name}} vient de vous envoyer un nouveau message"
}
La variable {{name}} est automatiquement remplacée par le nom du contact WhatsApp pour vous permettre d'identifier immédiatement l'interlocuteur.
Pour recevoir vos alertes WhatsApp directement dans un canal Slack :
Création de l'application : Rendez-vous sur api.slack.com/apps et cliquez sur Create New App. Sélectionnez l'option From scratch, nommez votre application (ex: Notifications Kanal) et choisissez votre espace de travail.
Activation des Webhooks : Dans le menu latéral, cliquez sur Incoming Webhooks et activez la fonctionnalité.
Génération de l'URL : Cliquez sur Add New Webhook to Workspace. Choisissez le canal de destination (ex: #support-whatsapp) et autorisez l'application.
Liaison avec Kanal : Copiez l'URL générée par Slack. Allez ensuite dans vos paramètres Kanal, section Webhooks, et collez l'URL dans le champ prévu à cet effet.
Dans Make, créez un nouveau scénario.
Ajoutez un module de type Webhook et choisissez le déclencheur Custom Webhook.
Cliquez sur Add pour générer une nouvelle URL et copiez-la.
Collez cette URL dans vos paramètres Kanal (Paramètres -> Webhooks).
Envoyez un message de test pour que Make puisse identifier automatiquement la structure des données (Data Mapping).
Créez un nouveau Zap.
Choisissez l'application Webhooks by Zapier comme événement déclencheur (Trigger).
Sélectionnez l'option Catch Hook et cliquez sur Continue.
Copiez l'URL du webhook fournie par Zapier et collez-la dans les paramètres de Kanal.
Effectuez un test d'envoi pour finaliser la configuration de votre Zap.
Ajoutez un nœud Webhook à votre flux de travail (Workflow).
Configurez le nœud pour qu'il accepte les requêtes de type POST.
Copiez l'URL de test ou de production générée par n8n.
Renseignez cette URL dans l'interface de Kanal.
Activez votre workflow pour commencer à recevoir les alertes.
Herald est une solution simple pour recevoir des notifications push personnalisées sur iOS sans développer d'application.
Téléchargez l'application Herald sur l'App Store.
Créez un nouveau point de terminaison (Endpoint) directement dans l'application.
Copiez l'URL du webhook fournie par Herald.
Configurez cette URL dans vos paramètres Kanal.
Vous recevrez désormais une notification sur votre iPhone à chaque nouveau message, dont vous pouvez personnaliser le format directement dans Herald.
Si vous ne recevez aucune notification après la configuration, veuillez vérifier les points suivants :
Exactitude de l'URL : Assurez-vous que l'URL copiée est complète et ne contient pas d'espaces superflus.
État du service tiers : Vérifiez que votre application Slack, votre Zap ou votre scénario Make est bien actif (On/Published).
Logs d'erreurs : Consultez les journaux d'erreurs de votre plateforme d'intégration (Zapier History ou Make Logs) pour voir si une requête a été reçue mais rejetée pour une raison technique.
En cas de difficulté persistante, notre équipe technique est disponible pour vous accompagner dans la mise en place de vos webhooks.