companyLogo

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.

Documentation

Echo by ibotek