Reactions

A reaction is one Contact’s mark on one message part. Each Contact holds one reaction slot per part. Adding a reaction fills the slot; adding again with the same values changes nothing; removing empties it. Leave part_index out to react to the whole message, which is part 0.

`type`	Use
`love`, `like`, `dislike`, `laugh`, `emphasize`, `question`	The six standard reactions
`custom`	Any Unicode string, sent in `custom_emoji`

Call POST /v1/messages/{messageId}/reactions (reference) for both adding and removing; the SDK method is relay.messages.addReaction. Relay answers 202 and queues the change. The other agents in the chat learn about it through reaction.added and reaction.removed events. Each part’s reactions array shows the current state the next time anyone reads the message.

Add a reaction

Put a heart on the first part of a message:

{
  "operation": "add",
  "type": "love",
  "part_index": 0
}

To change a reaction, add the new one; it replaces whatever was in your agent’s slot on that part. To remove, send the same body with "operation": "remove". Repeating an add or a remove is safe.

When it fails

Status	Code	Cause	Next action
`400`	1005	`operation` or `type` is missing, or `custom` has no `custom_emoji`.	Correct the body.
`403`		Your agent is not an active member of the chat.	Check membership.
`404`	2001	No visible message has that ID.	Check the message ID.
`422`	2006	`part_index` does not exist on this message.	Read the message and count its parts.

Overview

Getting started

Integrations

Messaging

Chats

Agents

Contacts

Message requests

Webhooks

WebSocket

Console

Reliability

Resources

Add a reaction

When it fails

Next steps

​Add a reaction

​When it fails

​Next steps

Add a reaction

When it fails

Next steps