A webhook is an address VisionScaper listens on. Your text or email service calls it when a customer replies, a message is delivered, or an email bounces. This is a technical article for the site administrator.

All addresses start with your site’s REST address (your site URL plus /wp-json/). The code uses the namespace dreamscaper/v1.

For the receptionist, ENGINE is retell, vapi or bland. Postcards have their own address, shown in Grow → Postcards → Settings.

1. Copy the address from the screen listed above. Do not type it by hand.
2. Paste it into your provider’s webhook setting. Follow the provider’s current instructions for where that is.
3. Choose the events to send. For Postmark, tick Delivery, Bounce, Spam Complaint and Subscription Change.
4. Where VisionScaper asks for a webhook secret, enter the same secret on both sides.

• Twilio requests are checked with Twilio’s signature using your Auth Token.
• The msg/webhook addresses check a header x-ENGINE-signature (for example x-telnyx-signature). The value must be the hex SHA-256 HMAC of the raw request body, made with the saved webhook secret. A missing secret or header always fails with “Bad signature.” The source says this is a generic stand-in and each provider’s own scheme is not implemented. Not verified against live provider traffic.
• Each event is saved once. A repeated delivery is acknowledged and ignored, so nothing is counted twice.

• delivered: the message shows as delivered.
• failed: shows “The carrier couldn’t deliver it”.
• bounced: the customer’s email is marked bounced.
• complained or unsubscribed: the customer is opted out of email.
• inbound text: logged on the customer, you get an alert “Text from (name)”, and the reply rules run.

• 403 “Bad signature”: the secret or header is wrong.
• Nothing arrives: your site must be reachable from the internet. A site behind a password or firewall will not receive webhooks.

• Set up Twilio for texting
• Set up Telnyx for texting
• Set up your email service