Skip to content
API PlatformDevelopers

Webhook events · conversations

conversation.reopened/1

Conversation reopened. A closed conversation was opened again.

Payload

We POST this JSON to your endpoint. Answer any 2xx within 30 seconds. The same id arrives again on a retry — skip ones you have handled.

Payload fields
FieldTypeWhat it is
idrequiredstringEvent id. The same on every retry: use it to skip duplicates.pattern ^evt_[0-9A-HJKMNP-TV-Z]{26}$
typerequiredstringEvent type.always conversation.reopened
versionrequiredstringPayload version.always 1
api_versionrequiredstringThe endpoint's API version.
occurred_atrequiredstringWhen it happened.date-time
company_idrequiredintegerYour workspace id.
datarequiredobject
idrequiredintegerConversation id.
company_idrequiredintegerWorkspace id.
staterequiredstringAlways open.always open
channel_idrequiredintegerChannel id.
contactobject or nullThe contact.
idrequiredintegerId.
namerequiredstring or nullName.
actorobject or nullWho did it.
idinteger or nullId.
namestring or nullName.
typerequiredstringstaff, bot, system or api.

Example

{
  "id": "evt_01J8Z7BZQ4F6G8J2K5N7Q9S1VC",
  "type": "conversation.reopened",
  "version": "1",
  "api_version": "2026-10-01",
  "occurred_at": "2026-09-24T09:20:00Z",
  "company_id": 1001,
  "data": {
    "id": 77410,
    "company_id": 1001,
    "state": "open",
    "channel_id": 301,
    "contact": {
      "id": 48213,
      "name": "Jane Doe"
    },
    "actor": null
  }
}

Headers

  • Webhook-Signature: t=…,v1=… — how to check it
  • Webhook-Id (also Webhook-Event-Id): the event id, the same on every retry — skip ones you have handled
  • Webhook-Delivery-Id: this delivery attempt, new on every try