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.
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…. Thetpart is when it was sent, in seconds. Eachv1is an HMAC-SHA256 of the texttimestamp.body(thetvalue, a dot, then the raw request body), made with your secret. Reject any request whosetis more than 5 minutes old, so an old request can't be replayed. Right after a secret change you may see twov1values: 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- Go to Channels and open Webhooks.
- Paste the URL your other tool gave you into Webhook URL. It must start with https://.
- Under Events, tick what you want to receive. Leave the two customer data switches off unless the receiving tool really needs names or messages.
- Save. Copy the signing secret from the window that opens and keep it somewhere safe. It is shown only once.
- 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- Open Channels → Webhooks and find Test delivery.
- Press Send test. Entagl sends a sample event to your URL straight away.
- 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
X-Entagl-Event-Id header. If a retry arrives for something your tool already handled, use that ID to skip it.Frequently asked questions
Was this page helpful?