Responder Mensagem

Metodo

POST https://oapi.ogmma.com.br/v1/channels/{channelId}/messages/reply

Conceituacao

Envia uma resposta (quote) a uma mensagem existente. A mensagem de resposta sera exibida no WhatsApp com uma referencia visual a mensagem original, facilitando o contexto da conversa.

Atributos

Header

Atributo	Tipo	Obrigatorio	Descricao
Authorization	string	Sim	Bearer {API_KEY} - Chave de autenticacao da API
Content-Type	string	Sim	application/json

Path Parameters

Atributo	Tipo	Obrigatorio	Descricao
channelId	string	Sim	ID do canal.

Body

Atributo	Tipo	Obrigatorio	Descricao
to	string	Sim	Numero do destinatario no formato DDI+DDD+NUM.
content	string	Sim	Texto da resposta.
repliedToMessageId	string	Sim	ID da mensagem original que esta sendo respondida.

Request

cURL

curl -X POST "https://oapi.ogmma.com.br/v1/channels/{channelId}/messages/reply" \
  -H "Authorization: Bearer {API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999998888",
    "content": "Sim, o pedido ja foi enviado!",
    "repliedToMessageId": "6650a1b2c3d4e5f6a7b8c9f0"
  }'

Node.js

const axios = require('axios');

const response = await axios.post(
  'https://oapi.ogmma.com.br/v1/channels/{channelId}/messages/reply',
  {
    to: "5511999998888",
    content: "Sim, o pedido ja foi enviado!",
    repliedToMessageId: "6650a1b2c3d4e5f6a7b8c9f0"
  },
  {
    headers: {
      'Authorization': 'Bearer {API_KEY}',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

Python

import requests

response = requests.post(
    'https://oapi.ogmma.com.br/v1/channels/{channelId}/messages/reply',
    json={
        'to': '5511999998888',
        'content': 'Sim, o pedido ja foi enviado!',
        'repliedToMessageId': '6650a1b2c3d4e5f6a7b8c9f0'
    },
    headers={
        'Authorization': 'Bearer {API_KEY}',
        'Content-Type': 'application/json'
    }
)

print(response.json())

Response

202 - Aceito

{
  "success": true,
  "message": "Mensagem enfileirada para envio"
}

400 - Dados invalidos

{
  "message": "Dados de entrada invalidos.",
  "code": "VALIDATION_ERROR",
  "errors": [
    {
      "field": "repliedToMessageId",
      "message": "O ID da mensagem original e obrigatorio."
    }
  ]
}

401 - Nao autorizado

{
  "message": "Token de autenticacao invalido ou ausente.",
  "code": "UNAUTHORIZED"
}

404 - Mensagem nao encontrada

{
  "message": "Mensagem original nao encontrada.",
  "code": "MESSAGE_NOT_FOUND"
}

429 - Rate limit excedido

{
  "message": "Limite de requisicoes excedido. Tente novamente em alguns segundos.",
  "code": "RATE_LIMIT_EXCEEDED"
}

Como obter o repliedToMessageId

O ID da mensagem original pode ser obtido de duas formas:

• Via webhook message.received: o campo data.message.id contem o ID da mensagem recebida
• Via API GET /channels/{channelId}/conversations/{conversationId}/messages: lista mensagens de uma conversa com seus IDs