Webhooks: signed events and retries
Set a webhook URL on your app. Echo POSTs JSON events to it and retries for a day if your server is down.
- echo.message.sent
- A text left a device.
- echo.message.failed
- A text could not be sent.
- echo.message.received
- A text reached one of your phones or numbers.
- echo.verification.approved
- A verification was approved.
- echo.call.completed
- A call rang.
- echo.call.failed
- A call failed.
Check the signature
Each delivery has an Echo-Signature header: t=<unix time>,v1=<HMAC-SHA256 of t.body with your webhook secret>. Check it and refuse anything older than 5 minutes.
- Answer with any 2xx within 5 seconds; do slow work afterwards.
- An event may arrive twice: use the Echo-Event-Id header to ignore repeats.
- Webhooks never carry codes or message texts. Read a text through the API.
