Editar Mensagem
Metodo
POST https://oapi.ogmma.com.br/v1/channels/{channelId}/messages/edit
Conceituacao
Edita o conteudo de uma mensagem de texto enviada anteriormente. A mensagem editada sera atualizada no WhatsApp do destinatario com uma indicacao de que foi editada.
Restricoes
- Apenas mensagens de texto (
type: "text") podem ser editadas. - Apenas mensagens enviadas (
direction: "OUTBOUND") podem ser editadas. - Janela de edicao: A edicao deve ocorrer em ate 15 minutos apos o envio original.
- Mensagens editadas exibem a indicacao "editada" no WhatsApp do destinatario.
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 |
|---|---|---|---|
| messageId | string | Sim | ID da mensagem a ser editada. |
| newText | string | Sim | Novo conteudo da mensagem de texto. |
Request
- cURL
- Node.js
- Python
curl -X POST "https://oapi.ogmma.com.br/v1/channels/{channelId}/messages/edit" \
-H "Authorization: Bearer {API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"messageId": "6650a1b2c3d4e5f6a7b8c9f0",
"newText": "Texto editado"
}'
const axios = require('axios');
const response = await axios.post(
'https://oapi.ogmma.com.br/v1/channels/{channelId}/messages/edit',
{
messageId: "6650a1b2c3d4e5f6a7b8c9f0",
newText: "Texto editado"
},
{
headers: {
'Authorization': 'Bearer {API_KEY}',
'Content-Type': 'application/json'
}
}
);
console.log(response.data);
import requests
response = requests.post(
'https://oapi.ogmma.com.br/v1/channels/{channelId}/messages/edit',
json={
'messageId': '6650a1b2c3d4e5f6a7b8c9f0',
'newText': 'Texto editado'
},
headers={
'Authorization': 'Bearer {API_KEY}',
'Content-Type': 'application/json'
}
)
print(response.json())
Response
200 - Edicao processada
{
"success": true,
"message": "Edicao processada"
}
400 - Fora da janela de edicao
{
"message": "A mensagem nao pode mais ser editada. O limite de 15 minutos foi excedido.",
"code": "EDIT_WINDOW_EXPIRED"
}
400 - Tipo de mensagem nao editavel
{
"message": "Apenas mensagens de texto enviadas podem ser editadas.",
"code": "MESSAGE_NOT_EDITABLE"
}
401 - Nao autorizado
{
"message": "Token de autenticacao invalido ou ausente.",
"code": "UNAUTHORIZED"
}
404 - Mensagem nao encontrada
{
"message": "Mensagem nao encontrada.",
"code": "MESSAGE_NOT_FOUND"
}
429 - Rate limit excedido
{
"message": "Limite de requisicoes excedido. Tente novamente em alguns segundos.",
"code": "RATE_LIMIT_EXCEEDED"
}