Skip to content
Channels & integrations

Webhooks

Tell your other tools the moment something happens in Entagl.

Overview

A webhook is a short message Entagl sends to another tool when something happens in your workspace: a new booking, a closed chat, a paid order. You choose the events and paste in the web address (URL) your other tool gave you. From then on Entagl posts the details there within seconds, so your CRM, spreadsheet or Make scenario can react without anyone copying data by hand. You'll find it under Channels → Webhooks.

For developers: API reference
Every endpoint, field and webhook event, with code samples.

Features

Pick the events you care about

Events are sorted into groups: Contacts, Conversations, Messages, Handovers to your team, AI agent, Bookings, Reminders, Orders, Products, Calls, Campaigns, Forms, Account and channels, and Workspace settings. Open a group and tick single events, or press Select all to take the whole group. Not sure where something lives? Type in the search box, for example "booking" or "tag". Tap any event to see an example of exactly what Entagl will send. Some events also let you choose where they come from, so you could get only the bookings your AI made and skip the ones your team typed into the calendar.

Incoming and Outgoing message: read the warning first

Incoming message and Outgoing message fire for every single message. On a busy account that can be thousands a day. That's why Select all skips them: you have to tick each one yourself, next to a warning. Turn them on only if the tool on the other end can handle that many. If you just want to know when a chat starts or ends, Conversation opened and Conversation closed are much quieter.

Customer data stays out unless you let it in

Two switches decide how much customer information leaves Entagl. Include message content adds what customers wrote: messages, notes and call summaries. Include contact details adds the customer's name, phone number and email. Both start off. You still get every event without them, with a contact ID where the details would be. Only the workspace owner or an admin can turn them on, and only do it if the receiving tool is allowed to store customer data. On a HIPAA workspace customer data is never sent, whatever the switches say.

Connected apps

Tools and developers can register their own webhooks through the Entagl API, and they show up under Connected apps by themselves. For each one you see how many events it listens to and when it last got one. You can open its Recent deliveries, Pause and Resume it, or Remove it. Make scenarios have their own page: Channels → Make.

See what was sent, and send it again

Press Recent deliveries to see the last 50 events Entagl tried to send, newest first. Each one shows whether it arrived, the answer your tool gave (like 200 or 500), how many tries it took, and when the next try is due. When a delivery has failed for good, fix the problem on your side and press Send again. Entagl sends it within a few seconds.

Retries, and what happens when a tool keeps failing

If your tool is down or answers with an error, Entagl tries again after 30 seconds, 2 minutes, 10 minutes, 1 hour, 6 hours and 24 hours. That's about 31 hours before a delivery is marked as failed. If a connected app keeps failing for 3 days straight, Entagl pauses it and sends the workspace owner a notification. Fix the tool, then press Resume. If Make reports that a scenario's webhook no longer exists, Entagl stops sending to it right away.

Check that a request really came from Entagl

Every request carries a signature in the X-Entagl-Signature header, made with your signing secret. Your developer uses it to prove the request came from Entagl and that nobody changed it on the way.

  • Connected apps and webhooks created through the API send t=1767225600,v1=5257a869…. The t part is when it was sent, in seconds. Each v1 is an HMAC-SHA256 of the text timestamp.body (the t value, a dot, then the raw request body), made with your secret. Reject any request whose t is more than 5 minutes old, so an old request can't be replayed. Right after a secret change you may see two v1 values: accept the request if either one matches.
  • The webhook you set up on this page sends sha256= followed by an HMAC-SHA256 of the raw request body.

Common tasks

Connect a webhook

About 3 min
  1. Go to Channels and open Webhooks.
  2. Paste the URL your other tool gave you into Webhook URL. It must start with https://.
  3. Under Events, tick what you want to receive. Leave the two customer data switches off unless the receiving tool really needs names or messages.
  4. Save. Copy the signing secret from the window that opens and keep it somewhere safe. It is shown only once.
  5. Check that the switch at the top of the card is on and shows Active. Events start flowing from that moment.

Test your webhook

About 1 min
  1. Open Channels → Webhooks and find Test delivery.
  2. Press Send test. Entagl sends a sample event to your URL straight away.
  3. Read the result. Test delivered means your tool answered. If it failed, the message tells you why (for example a timeout), so you can fix it and try again.

Tips

Each request has an event ID in the X-Entagl-Event-Id header. If a retry arrives for something your tool already handled, use that ID to skip it.
On the webhook you set up on this page, Booking created and Booking documents added are sent once, the moment they happen, without the retry schedule. Keep that URL reachable.
Answer fast. Your tool should reply with a success code (any 2xx) within 5 seconds and do slow work afterwards. A slow answer counts as a failure and gets retried.
Pause is the gentle option: the connection stays, nothing is sent, and Resume picks up again with new events. Remove deletes the connection.

Frequently asked questions

Was this page helpful?