Webhooks

What is a Kanal webhook??

A Kanal webhook enables you to automatically receive a notification each time a new message is received. These notifications can be sent to different services or applications.

Data formats

When a new message is received, Kanal sends a POST request to your webhook with the following data in JSON format:

{
  "title": "Nouveau message sur Kanal",
  "body": "{{name}} vient de vous envoyer un nouveau message"
}

• Keep your webhook URL private

• Use HTTPS for secure transmission

• Avoid sharing logs containing webhook URLs

• Change your webhook URLs regularly for greater security

Troubleshooting If you don't receive notifications :

1. Check that the webhook URL has been copied correctly

2. Check that the webhook service is active

3. Check your integration platform logs

Configuration by platform

Slack

You can use Slack directly or use Zapier or Make or n8n as a bridge to receive webhooks.

Slack allows you to receive Kanal webhook notifications directly in a channel using Incoming Webhooks. Follow these steps to set it up:

1. Create a Slack App:

   • Go to api.slack.com/apps and click Create New App.
   • Choose “From scratch,” provide a name (e.g., “Kanal Notifications”), and select your Slack workspace.

2. Enable Incoming Webhooks:

   • In the left sidebar, select Incoming Webhooks.

   • Toggle Activate Incoming Webhooks to “On”.

3. Add a Webhook to Your Workspace:

   • Scroll down and click Add New Webhook to Workspace.

   • Select the Slack channel where you want notifications to appear (e.g., #kanal-notifications).

   • Click Allow to authorize the app.

4. Copy the Webhook URL:

   • After authorization, Slack will generate a webhook URL (e.g., https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX).

   • Copy this URL.

5. Configure the Webhook in Kanal:

   • In Kanal, go to Settings -> Webhooks.

   • Paste the Slack webhook URL into the “Webhooks” section.

Make (formerly Integromat)

1. In Make, create a new scenario

2. Add a “Webhook” trigger

3. Copy the webhook URL provided by Make

4. In Kanal, go to Settings -> Webhooks

5. Paste the Make webhook URL in the “Webhooks” section

6. Test the connection by sending a test message

Zapier

1. Create a new Zap Select “Webhooks by Zapier” as trigger

2. Select “Catch Hook” as event

3. Copy the webhook URL provided by Zapier

4. Configure the webhook in Kanal as described above

5. Send a test message to complete the Zap configuration

n8n

1. Add a “Webhook” node to your workflow

2. Configure the node to receive POST requests

3. Copy the generated webhook URL

4. Add URL to Kanal parameters

5. Test the connection

Herald (iOS)

1. Download the Herald application on the App Store

2. Create a new endpoint in Herald

3. Copy the webhook URL provided

4. Configure the webhook in Kanal

5. Customize notification format in Herald