Skip to main content

Managing edna Pulse Webhooks

Last updated: 29 April 2026
warning

Make sure the URLs you use are up to date, otherwise you won't be able to retrieve the data.

File IconGeneral Information about edna Pulse API Keys and Webhooks File IconHow to Choose the Right API Key and Webhook Type

How to Enable Authentication for Master Webhooks to Your Server​

  1. Go to the Integration → Settings → Main profile tab.

    alt

  2. In the Webhook request authentication section, check the Authenticate webhooks from edna Pulse box to generate an API key.

  3. Click New webhook key and copy the displayed API key.

    warning

    For security reasons, the API key is only displayed and available for copying once. After refreshing the page, it is masked and becomes unavailable. Make sure you save the key in a secure location or provide it to your developer.

edna Pulse will use the generated API key when sending webhooks to your URL.

How to Configure URLs for Master Webhooks​

  1. Go to the Integration → Settings → Main profile tab.

  2. In the Webhook URL setup section, expand the setting with the appropriate event type for webhooks.

    File IconEvent Types for Webhooks

  3. Click Add a webhook URL.

  4. Enter the appropriate URL and click Add.

    tip

    Your URL should be valid and accessible from the public internet. Use only the secure HTTPS protocol: TCP port 443 by default.

  5. Wait for the specified URL to be verified.

    info

    To verify availability, edna Pulse will send a test HEAD request and expects to receive a response with a 200 status code. If no such response is received, edna Pulse will retry up to three times: after 4, 128, and 2048 seconds.

    If a 200 response is not received after all attempts, the specified URL will not be added. Try adding a different URL.

After adding a valid URL, the webhook changes to the status

Connected
— data retrieval is available.

Event Types for Webhooks​

Webhook URL for statuses
WhatsApp
Viber
​

Retrieving the delivery status of sent messages.

File IconReceiving Message Statuses

Webhook URL for incoming messages
WhatsApp
Viber
​

Receiving incoming messages from customers.

File IconReceiving Messages

Webhook URL for template registration status updates
WhatsApp
Viber
​

Receiving updates on template statuses.

File IconReceiving Template Registration Status

Webhook URL for WhatsApp template category changes
WhatsApp
​

Receiving information about updates to the WhatsApp template category from Meta.

File IconWebhook Request about Changing WhatsApp Template Category

Webhook URL for tracking clicks on the WhatsApp link button
WhatsApp
​

Retrieving information about recipients' clicks on links in WhatsApp messages.

File IconWebhook Request about Clicking on WhatsApp Link Buttons

How to Add an Additional Webhook​

  1. Go to the Integration → Settings → Webhook tab.

  2. Click Add Webhook.

  3. Enter an internal name for the webhook, which will be displayed in the general list.

  4. Enter the URL of your server where webhooks containing event information will be sent.

    tip

    Your URL should be valid and accessible from the public internet. Use only the secure HTTPS protocol: TCP port 443 by default.

  5. (Optional) Enter an additional URL for your server.

  6. (Optional) Toggle the edna Pulse request authentication switch to generate an API key that edna Pulse will use when sending webhooks to your URL.

  7. The Senders dropdown list displays the internal names of connected channels with the status

    Correct
    : select one or more channels whose events will trigger the sending of webhooks.

    File Iconedna Pulse Channels

  8. Select one or more types of webhooks that will be sent to the specified URL:

    • for statuses;
    • for incoming messages;
    • for updates to template registration statuses;
    • for changes to the WhatsApp template category;
    • for the recipient clicking a link button in WhatsApp.

  9. Click Save.

  10. If you enabled the edna Pulse request authentication toggle in step 6, copy the displayed API key.

    warning

    For security reasons, the API key is only displayed and available for copying once. After refreshing the page, it is masked and becomes unavailable. Make sure you save the key in a secure location or provide it to your developer.

  11. Wait for the specified URL to be verified.

    info

    To verify availability, edna Pulse will send a test HEAD request and expects to receive a response with a 200 status code. If no such response is received, edna Pulse will retry up to three times: after 4, 128, and 2048 seconds.

    If a 200 response is not received after all attempts, the specified URL will not be added. Try adding a different URL.