Webhooks for new messages
A Spaces webhook tells your own system the moment something happens on a connected account, such as a new message, a new comment or an account that needs reconnecting. Webhooks are included on the Pro, Team and Agency plans.
What it does
A webhook sends a short, signed notice to an address you choose each time a new message, comment or other event arrives.
Customer on WhatsApp: Hi, can I book a table for four on Friday?
Spaces, to your booking system: New message received on your WhatsApp account, with the chat and the text.
Your booking system: Saves the enquiry and lets your AI agent know there is a new booking request to answer.
What a webhook is for
Most owners never need to think about webhooks: your AI agent checks for new messages through Spaces and answers them. A webhook is for when another system should hear about a message too, such as a booking tool, an order system or an app a developer built for you.
Instead of that system asking again and again whether anything is new, Spaces sends it a notice the moment something happens. Your developer, or an AI agent that can work with an API, sets it up once with your key.
What it can tell you about
You choose which events a webhook receives, for every account or one account only. They include:
- a new message received, read, delivered, edited, deleted or reacted to
- a message your agent sent through Spaces going out
- a new comment on one of your posts, and a post being published
- a reply or post waiting for your approval
- a chat handed to a person on your team, or handed back to the agent
- a new follower where the platform reports it, and on LinkedIn an invitation received or accepted
- an account that was signed out, reconnected, or asked by the platform to slow down
Signed, and easy to check
Every webhook is signed with a secret that is shown to you once, so your system can check that the notice really came from Spaces. Each event has its own id, so a repeated delivery is never mistaken for a second message.
You can send a test event at any time, see the past week of deliveries and how your server answered, and send one again. The delivery history never holds the message text.
For agents without webhooks
An AI agent does not need a webhook to hear about new messages. It can wait for the next event from Spaces and get it the moment it arrives, and this never touches the platform, so it is safe to do as often as it likes. An agent running on a server can also have its own events sent to an address of its choosing.
How to use it with your AI agent
- Choose a plan with webhooks. Webhooks are included on Pro, Team and Agency. The pricing page shows what each plan includes.
- Connect your accounts. In your Spaces dashboard, connect the accounts you already use. WhatsApp links with a QR code, the same way you would link WhatsApp on a computer. Instagram, LinkedIn, Messenger, X and email connect by signing in through a secure link.
- Create the webhook. Give your developer, or an AI agent that can use the API, your key and the address that should receive events. They choose the events and, if needed, one account.
- Test it. Send a test event to check your system answers, then watch the delivery history for the first few days.
Things you can say to your agent:
- “Send every new WhatsApp message to our booking system’s webhook address.”
- “Tell our app whenever a reply is waiting for my approval.”
- “Did yesterday’s webhook deliveries all go through?”
- “Let me know when any account is signed out.”
Setup for each AI agent is on Connect your AI agent.
Which channels support it
- WhatsApp: New messages, reactions, hand-overs and account changes.
- Instagram: New messages, comments on your posts, published posts and account changes.
- LinkedIn: New messages, comments, published posts, invitations received and accepted, and account changes.
- Messenger: New messages, hand-overs and account changes.
- X: New messages, hand-overs and account changes.
- Email: Account changes, such as a mailbox that needs reconnecting.
- iMessage: Coming soon: text your own AI agent from your phone.
Webhooks are not included on Starter.
Webhooks are set up through the API with a key, not from the dashboard.
Limits that apply
- Webhooks send nothing to your customers, so they do not use your accounts’ sending limits.
- Failed deliveries to an agent’s own events address are retried for about a day, and that address is turned off after 50 failures in a row.
- Each key can have at most 3 of its own event addresses.
- Events can be caught up for 14 days, and message text in an event is cut to a thousand characters.
Every channel’s limits are on sending limits, and how Spaces protects accounts is on account safety.
FAQ
What is a webhook?
A notice Spaces sends to an address you choose the moment something happens, such as a new message, so your other systems hear about it straight away.
Which plans include webhooks?
Pro, Team and Agency. Starter does not include them. The pricing page has the details.
Do I need a webhook for my AI agent to answer messages?
No. Your agent can wait for new events from Spaces directly. A webhook is for other systems that should hear about messages too.
Can I get webhooks for one account only?
Yes. A webhook can cover every account in the workspace or just one, which helps when each client has their own system.
How do I know a webhook really came from Spaces?
Each one is signed with a secret shown to you once. Your system checks the signature before trusting the notice.
Can I hear about replies waiting for approval?
Yes. If you ask your AI agent to hold replies as drafts, a webhook can tell your system each time one is waiting.
Try it with your own accounts
Connect an account, add Spaces to your AI agent and try webhooks today. Every plan starts with a trial. No card needed.
Read more
Other features: One inbox, Scheduled messages, Auto-replies, Comment-to-DM, Hand-over, Pause and approvals, Follow-ups, Safe sending, Publish posts, Schedule posts, Message requests, Story replies, People lookup, Many accounts.