Skip to content

Event Catalog

Available events

Group	Event	Fires when
Messaging	`message.received`	An inbound message arrives from a customer (WhatsApp, Instagram DM, Messenger)
	`message.sent`	An outbound message is accepted by the channel
	`message.delivered`	An outbound message is delivered to the device
	`message.read`	The customer reads your outbound message
	`message.failed`	Message delivery permanently fails
Conversations	`conversation.created`	A new conversation is started
	`conversation.status_changed`	A conversation is opened, closed, set to pending, or gets a new status label
	`conversation.assigned`	A conversation is assigned to a team member or returned to the queue
Contacts	`contact.created`	A contact is added — manually, by API, or from a first inbound message
	`contact.updated`	A contact’s fields change
	`contact.tagged`	Tags are added to or removed from a contact, including automatic behaviour tags
Campaigns	`broadcast.completed`	A broadcast send finishes (all messages dispatched)
	`sequence.enrolled`	A contact is enrolled in a drip sequence
	`sequence.completed`	A contact reaches the end of a sequence
Social publishing	`social_post.published`	A LinkedIn, Instagram, or Facebook post goes live
	`social_post.failed`	A post could not be published
	`comment.received`	Someone comments on one of your Instagram or Facebook posts
CRM	`deal.created`	A deal is added to a pipeline
	`deal.stage_changed`	A deal moves to another pipeline stage
	`deal.status_changed`	A deal is marked won, lost, or reopened

Every delivery carries the event name in the X-Tenreply-Event header and an HMAC signature in X-Tenreply-Signature. Full payload examples for every event are in the n8n triggers reference; the shapes are identical whichever integration receives them.

Sample payloads

`message.received`

{
  "message": {
    "id": "msg_123",
    "conversationId": "conv_abc",
    "contactId": "contact_xyz",
    "direction": "inbound",
    "type": "text",
    "content": { "text": "Hello, I need help!" },
    "status": "delivered",
    "waMessageId": "wamid.abcdef",
    "timestamp": "2026-06-01T10:00:00.000Z"
  },
  "contact": { "id": "contact_xyz", "name": "Jane Doe", "phoneNumber": "+1234567890" },
  "conversation": { "id": "conv_abc", "status": "open", "channel": "whatsapp" }
}

`contact.created`

{
  "contact": {
    "id": "contact_xyz",
    "phoneNumber": "+1234567890",
    "name": "Jane Doe",
    "email": "jane@example.com",
    "tags": ["vip"],
    "createdAt": "2026-06-01T10:00:00.000Z"
  }
}

`message.delivered` / `message.read` / `message.failed`

{
  "waMessageId": "wamid.abcdef",
  "status": "delivered",
  "errorMessage": null
}