> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zapclass.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Editar Mensagem

> Editar o conteúdo de uma mensagem já enviada

Modifica o texto de mensagens enviadas pela sua instância, utilizando a funcionalidade nativa de edição do WhatsApp com sincronização automática.

## Como Funciona a Edição

> **Processo de Edição**
>
> O sistema realiza uma série de validações e operações para garantir a edição correta.
>
> **Fluxo de execução:**
>
> 1. Busca a mensagem original pelo ID fornecido
> 2. Valida se a mensagem pertence à instância
> 3. Edita o conteúdo no WhatsApp
> 4. Gera novo ID para a versão editada
> 5. Atualiza registro no banco de dados
> 6. Dispara eventos SSE/Webhook

> **Formatos de ID Aceitos**
>
> O endpoint aceita dois formatos diferentes de ID para flexibilidade.
>
> **Formatos suportados:**
>
> * **Completo:** `owner:messageid` (ex: `5511999999999:3A123456789`)
> * **Simplificado:** `messageid` (ex: `3A12345678901234567890123456789012`)
>
> O sistema identifica automaticamente o formato e processa adequadamente.

> **Eventos e Notificações**
>
> A edição dispara eventos automáticos para integração com outros sistemas.
>
> **Comportamento:**
>
> * Webhook recebe notificação de mensagem editada
> * SSE transmite evento em tempo real
> * Retorna objeto completo da mensagem atualizada
> * Mantém histórico de edições no banco de dados

> **Limitações Importantes**
>
> Algumas restrições se aplicam à edição de mensagens.
>
> **Restrições:**
>
> * Apenas mensagens enviadas pela própria instância
> * Mensagem deve existir no banco de dados
> * Prazo de edição limitado pelo WhatsApp (15 minutos)
> * Não é possível editar mensagens de mídia
> * Apenas conteúdo de texto pode ser modificado

### Authorization

**api\_key** `string` *required*

Chave de autenticação da sua conexão, utilizada no header Authorization como
**Bearer** Token. \\

Você encontra sua API Key no botão **API** da sua conexão no painel ZapClass. \\

A chave sempre começa com o prefixo `zc_`. \\

Exemplo: `zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP`

### Body Parameters

**id** `string` *required*

ID único da mensagem que será editada. \\

Exemplo: `5511999999999:1AB2C3DEFG4H56I78JKL9M`

**message** `string` *required*

Novo conteúdo de texto da mensagem. \\

Substitui completamente o texto original. \\

Exemplo: `Texto editado da mensagem`

> [!WARNING]
>
> **Atenção:** O WhatsApp permite editar mensagens apenas dentro de 15 minutos
> após o envio. Após esse período, a edição será rejeitada.

```bash cURL theme={null}
curl -X POST https://zapclass.com.br/api/messages/edit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP" \
  -d '{
    "id": "5511999999999:1AB2C3DEFG4H56I78JKL9M",
    "message": "Texto corrigido da mensagem"
  }'
```

```javascript JavaScript theme={null}
const response = await fetch("https://zapclass.com.br/api/messages/edit", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP",
  },
  body: JSON.stringify({
    id: "5511999999999:1AB2C3DEFG4H56I78JKL9M",
    message: "Texto corrigido da mensagem",
  }),
});
```

```php PHP theme={null}
<?php
$ch = curl_init('https://zapclass.com.br/api/messages/edit');

$payload = [
    "id" => "5511999999999:1AB2C3DEFG4H56I78JKL9M",
    "message" => "Texto corrigido da mensagem"
];

curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

curl_exec($ch);
curl_close($ch);
?>
```

```json 200 theme={null}
{
  "success": true
}
```

```json 400 theme={null}
{
  "success": false,
  "message": "Token de autenticação inválido"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.