Bird in Superagent · Screen inbound messages before your agent reads them — Bird
Screen inbound messages before your agent reads them
Superagent screens inbound email, SMS, and WhatsApp messages delivered by Bird for prompt injection and malicious links, so your application can drop dangerous payloads, route questionable replies to a human queue, and pass clean messages to your agent.
Receive messages on your webhook and score them with Superagent
Host an HTTPS webhook endpoint to receive inbound messages from Bird and run them through Superagent before your agent processes a reply. Bird delivers the event to your server, your worker submits the message content to Superagent, and the returned verdict determines whether the message reaches your agent, goes to a human reviewer, or gets dropped.
- Subscribe to Bird's received events
Create a webhook under Developers pointed at your HTTPS endpoint for the inbound channels your workspace handles. Bird returns a webhook signing secret once when you create the subscription, so save it to your environment secrets before closing the pane. - Verify the signature, then queue
- Scan the content and act on the verdict
Bird dashboard
- Developers
- ›Webhooks
- ›Create webhook
URL: https://your-app.example.com/bird/inbound
Event: email.received, sms.received, whatsapp.received
Response: whsec_...
Bird shows the webhook signing secret once on creation. Store it as an environment secret before leaving the pane.
Screen message text and embedded links across email, SMS, and WhatsApp while routing attachments and media through your own inspection pipeline.
Three inbound channels.
Screen incoming email, SMS, and WhatsApp replies from one webhook endpoint by subscribing to the channels your workspace receives on.
$email.received
$sms.received
Four verdicts, three outcomes.
Block suspicious and dangerous messages at the perimeter, route caution verdicts to a human reviewer, and let your agent act on safe messages.
$safe
$caution
$dangerous
Message text and links.
Superagent inspects message bodies and URLs. Handle images, audio, video, documents, and attachments through a separate scanner before passing files to an agent.
$text
$https links
Worth wiring up
Hold an inbound support email until Superagent returns a safe verdict.
Copy Drop an inbound SMS that scores dangerous and log the verdict for review.
Copy Route messages marked caution to a human support queue.
Copy Store the verdict on the conversation thread so later replies keep that context.
Copy Alert your security team when suspicious messages spike on an inbox address.
Copy Reject webhook deliveries that fail Standard Webhooks signature verification.
Put it into practice.
Continue with the documentation, guides, and examples for this topic.