Actions47
- Account Actions
- Chat Actions
- Contact Actions
- Group Actions
- Location Actions
- Message Actions
- Number Actions
- Phone Number Actions
- Poll Actions
- Reaction Actions
- Typing Indicator Actions
- Webhook Actions
Reaction → Add or Remove
AI-generatedSummary
Add or remove a reaction (tapback or emoji) to a message in a conversation.
Inputs
- chatId (required) — Conversation identifier: phone number (E.164), email, or group ID (grp_xxx).
- messageId (required) — Message ID (e.g. msg_abc123) or a relative index: -1 for the last message, -2 for second-to-last, etc.
- direction — Only used when Message ID is a relative index (-1, -2). Filters which message direction the index counts.
- reaction (required) — Prefix with + to add or - to remove. Classic tapbacks: love, like, dislike, laugh, emphasize, question (e.g. +love). Emoji: any emoji (e.g. +😂, -🔥).
Output shape
no body — success/failure only
Returns a success status if the reaction is added or removed; otherwise returns an error.
Examples
Example 1: Add a 'love' reaction to the last message in a chat.
Chat ID: +15551234567, Message ID: -1, Reaction: +love, Direction: Any
Example 2: Remove a 'fire' emoji reaction from a specific message.
Chat ID: +15551234567, Message ID: msg_abc123, Reaction: -🔥