Respostas Rápidas
Criar, atualizar ou excluir resposta rápida
/quickreply/editAutenticação: envie a chave da conexão no header token ou em Authorization: Bearer.
Gerencia templates de respostas rápidas para agilizar o atendimento. Por padrão, cria respostas rápidas locais. Para criar/sincronizar uma resposta rápida no WhatsApp Business, envie onWhatsApp: true.
- Para criar: não inclua o campo
id - Para atualizar: inclua o
idexistente - Para excluir: defina
delete: truee inclua oid
Observação: respostas rápidas sincronizadas com o WhatsApp suportam apenas type: text. Não é possível converter uma resposta rápida local existente em resposta do WhatsApp; para criar no WhatsApp, envie onWhatsApp: true sem id.
Corpo da requisição (JSON)
| Campo | Tipo | Descrição |
|---|---|---|
| id | string | Necessário para atualizações/exclusões, omitir para criação Exemplo: rb9da9c03637452 |
| delete | boolean | Definir como true para excluir o template Exemplo: false |
| onWhatsApp | boolean | Quando true, cria/sincroniza a resposta rápida no WhatsApp Business via app state. Disponível apenas para type=text. Exemplo: false |
| shortCut* | string | Atalho para acesso rápido ao template Exemplo: saudacao1 |
| type* | string | Tipo da mensagem |
| text | string | Obrigatório para mensagens do tipo texto Exemplo: Olá! Como posso ajudar hoje? |
| file | string | URL ou Base64 para tipos de mídia Exemplo: https://exemplo.com/arquivo.pdf |
| docName | string | Nome do arquivo opcional para tipo documento Exemplo: apresentacao.pdf |
* obrigatório
Exemplos de corpo
Criar apenas na API
{
"shortCut": "saudacao",
"type": "text",
"text": "Olá! Como posso ajudar?"
}Criar na API e no WhatsApp Business
{
"onWhatsApp": true,
"shortCut": "saudacao",
"type": "text",
"text": "Olá! Como posso ajudar?"
}Editar resposta rápida existente
{
"id": "rb9da9c03637452",
"shortCut": "saudacao",
"type": "text",
"text": "Olá! Como posso ajudar hoje?"
}Respostas
- 200Operação concluída com sucesso
- 400Requisição inválida (erro de validação)
- 404Template não encontrado
- 500Erro no servidor ou falha ao sincronizar com WhatsApp
Experimente
Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.