JawblyJawblyDocs

Webhooks

Register an HTTPS endpoint and Jawbly will POST an event to it whenever something happens: a customer messages you, a lead is captured, a conversation is handed off. Every delivery is signed so you can verify it came from us.

Delivery

Events are delivered as signed JSON. Verify the signature with your webhook secret before trusting a payload.

request
POST https://your-app.com/webhooks/jawbly
X-Jawbly-Signature: sha256=…
Content-Type: application/json

The signature is an HMAC-SHA256 of the raw body using your secret, sent in X-Jawbly-Signature.

Events

Subscribe to only the events you need.

message.received

A customer sent a message to your number.

payload
{
  "type": "message.received",
  "conversationId": "conv_8fA1…",
  "from": "+14155550123",
  "text": "Do you have this in size M?"
}
message.sent

Your assistant (or your API call) sent a message.

conversation.handoff

A conversation was handed off to a human.

record.created

A record was captured (order, lead or booking).

payload
{
  "type": "record.created",
  "collection": "orders",
  "record": {
    "id": "rec_44…",
    "fields": {
      "item": "Blue jacket",
      "qty": 1
    }
  }
}
contact.created

A new contact was seen for the first time.