NODAPI

Respostas Rápidas

Criar, atualizar ou excluir resposta rápida

POST/quickreply/edit

Autenticaçã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 id existente
  • Para excluir: defina delete: true e inclua o id

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)

CampoTipoDescrição
idstring

Necessário para atualizações/exclusões, omitir para criação

Exemplo: rb9da9c03637452

deleteboolean

Definir como true para excluir o template

Exemplo: false

onWhatsAppboolean

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

textstring

Obrigatório para mensagens do tipo texto

Exemplo: Olá! Como posso ajudar hoje?

filestring

URL ou Base64 para tipos de mídia

Exemplo: https://exemplo.com/arquivo.pdf

docNamestring

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.

Cole a chave gerada no painel.