inbox.quick_reply_send
Enviar uma resposta rápida na conversa. Resolve as variáveis e envia pelo canal da conversa. Cloud API (whatsapp_cloud/gupshup), janela aberta: mensagem interativa nativa (mode: "interactive", botões de resposta ou de link; salva como texto com payload.interactive). Evolution, Instagram e Telegram: texto com opções numeradas (mode: "numbered_list"). Tipo texto: texto simples. Janela de 24 h fechada recusa (WhatsApp oficial e Instagram). Resposta rápida de outro canal recusa.
- Endpoint:
POST https://app.atomiks.com.br/api/v1/inbox.quick_reply_send(corpo JSON) - Quem pode chamar: membro da conta
- Escopo da chave:
messages:send - Grava dados: sim
- Pela chave de API: sim
- Ferramenta MCP:
inbox_quick_reply_send - Ficha em JSON:
https://app.atomiks.com.br/api/v1/openapi.json(operationIdinbox.quick_reply_send)
Entrada
| Campo | Tipo | Obrigatório | Nota |
|---|---|---|---|
conversationId | string (uuid) | sim | |
quickReplyId | string (uuid) | sim | |
clientRequestId | string (uuid) | não |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"conversationId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"quickReplyId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"required": [
"conversationId",
"quickReplyId"
]
}Exemplo
curl -X POST https://app.atomiks.com.br/api/v1/inbox.quick_reply_send \
-H "Authorization: Bearer $ATOMIKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"conversationId":"00000000-0000-0000-0000-000000000000","quickReplyId":"00000000-0000-0000-0000-000000000000"}'CLI:
node cli/atomiks.mjs inbox.quick_reply_send --json '{"conversationId":"00000000-0000-0000-0000-000000000000","quickReplyId":"00000000-0000-0000-0000-000000000000"}'MCP: ferramenta inbox_quick_reply_send com a mesma entrada.
Saída
Sucesso: {"data": ...} com o formato abaixo.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"message": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"conversationId": {
"type": "string"
},
"direction": {
"type": "string",
"enum": [
"inbound",
"outbound",
"outbound_echo",
"internal",
"system"
]
},
"source": {
"type": "string",
"enum": [
"live",
"history"
]
},
"type": {
"type": "string"
},
"body": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"errorMessage": {
"type": [
"string",
"null"
]
},
"metaTimestamp": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string"
},
"sentBy": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"media": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"mimeType": {
"type": "string"
},
"filename": {
"type": [
"string",
"null"
]
},
"sizeBytes": {
"type": [
"number",
"null"
]
},
"state": {
"type": "string",
"enum": [
"pending",
"available",
"failed",
"expired"
]
}
},
"required": [
"id",
"mimeType",
"filename",
"sizeBytes",
"state"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"payload": {
"anyOf": [
{},
{
"type": "null"
}
]
},
"replyTo": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"body": {
"type": [
"string",
"null"
]
},
"type": {
"type": "string"
},
"senderName": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"body",
"type",
"senderName"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"reactions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"emoji": {
"type": "string"
},
"mine": {
"type": "boolean"
},
"fromContact": {
"type": "boolean"
}
},
"required": [
"emoji",
"mine",
"fromContact"
],
"additionalProperties": false
}
},
"isFavorited": {
"type": "boolean"
},
"parentNoteId": {
"type": [
"string",
"null"
]
},
"edited": {
"type": "boolean"
},
"deleted": {
"type": "boolean"
},
"editedAt": {
"type": [
"string",
"null"
]
},
"deletedAt": {
"type": [
"string",
"null"
]
},
"clientRequestId": {
"type": [
"string",
"null"
]
},
"scheduled": {
"type": "boolean"
},
"senderName": {
"type": [
"string",
"null"
]
},
"senderJid": {
"type": [
"string",
"null"
]
},
"meta": {
"anyOf": [
{},
{
"type": "null"
}
]
},
"rawType": {
"type": [
"string",
"null"
]
},
"origin": {
"anyOf": [
{
"type": "string",
"enum": [
"phone",
"automation",
"flow"
]
},
{
"type": "null"
}
]
},
"originLabel": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"conversationId",
"direction",
"source",
"type",
"body",
"status",
"errorMessage",
"metaTimestamp",
"createdAt",
"sentBy",
"media",
"payload",
"replyTo",
"reactions",
"isFavorited",
"parentNoteId",
"edited",
"deleted",
"editedAt",
"deletedAt",
"senderName",
"senderJid"
],
"additionalProperties": false
},
"uncertain": {
"type": "boolean"
},
"mode": {
"type": "string",
"enum": [
"interactive",
"numbered_list",
"text"
]
}
},
"required": [
"message",
"uncertain",
"mode"
],
"additionalProperties": false
}Erros
{"error": {"code", "message", "requestId"}}. Códigos: invalid_input (400), unauthorized (401), forbidden / account_pending / scope_missing (403), not_found (404), limit_reached (409), internal (500).