API REST · mensagens

POST https://api.pulpo.chat/v1/messages
Token: TU_CLAVE_DE_API
Content-Type: application/json

{
  "phone": "+14155550187",
  "message": "Seu pedido está preparado para retirar na loja."
}

Mensagem criada · 201

HTTP/1.1 201 Created
{"id":"ID_MENSAJE_DE_EJEMPLO"}

API do WhatsApp para seu sistema

Seu sistema avisa.Sua equipe continua a conversa.

Quando um pedido está preparado, seu sistema pode criar a mensagem. Sua equipe continua a conversa no Pulpo.

Começar grátis Veja em ação

Dados fictícios. Use uma conta autorizada, um número operacional e as condições de envio correspondentes.

Requisição, evento e modelo.

Exemplos de operações documentadas. Consulte o esquema completo e teste com sua conta antes de integrar.

O pedido já está preparado

Criar uma mensagem

Avisar que o pedido pode ser retirado.

Seu servidor usa o cabeçalho Token e o corpo da requisição. O destinatário e o texto deste exemplo são fictícios.

PulpoChatAPI REST · mensagens

Requisição de exemplo

POST https://api.pulpo.chat/v1/messages
Token: TU_CLAVE_DE_API
Content-Type: application/json

{
  "phone": "+14155550187",
  "message": "Seu pedido está preparado para retirar na loja."
}

Mensagem criada · 201

HTTP/1.1 201 Created
{"id":"ID_MENSAJE_DE_EJEMPLO"}

O 201 confirma a criação da mensagem. Consulte sua evolução antes de presumir que chegou ao destinatário.

Confira o acesso ao número, a permissão do destinatário e as regras de envio. Se tiver vários números, consulte o campo device na documentação.

Chega uma nova conversa

Receber um evento

Informar seu sistema sobre uma mensagem recebida.

Você configura sua URL de webhook e os eventos de que precisa. Este fragmento mostra campos de um evento; não é o esquema completo.

PulpoChatWebhook · mensagem recebida

POST para seu servidor · exemplo

POST https://tu-servidor.example/webhooks/pulpo
Content-Type: application/json
X-Idempotency-Key: ID_EVENTO_DE_EJEMPLO

{
  "id": "ID_MENSAJE_DE_EJEMPLO",
  "object": "message",
  "event": "message:in:new"
}

Resposta do seu servidor · exemplo

HTTP/1.1 200 OK

Seu servidor processa o evento e decide o que fazer com ele. Prepare o tratamento de novas tentativas para evitar processar o mesmo evento várias vezes.

Use HTTPS em produção e valide o esquema completo. Receber um webhook não envia uma resposta de WhatsApp por si só.

Você prepara um aviso proativo

Consultar modelos

Encontrar um modelo aprovado para o aviso.

Consulte os modelos da conta e confira nome, idioma e conteúdo antes de preparar o envio.

PulpoChatAPI REST · modelos

Consulta de exemplo

GET https://api.pulpo.chat/v1/waba/templates?status=approved
Token: TU_CLAVE_DE_API

Fragmento de resposta · exemplo

{"data":[{"name":"PLANTILLA_DE_EJEMPLO",
"status":"approved","language":"es"}],
"total":1,"page":0,"size":1}

A consulta retorna os modelos que você pode revisar. Para enviar, siga o formato e os requisitos da documentação.

Os modelos aprovados são necessários quando as regras do WhatsApp os exigem. Esta consulta não cria nem envia uma mensagem.

Do exemplo à integração.

Teste a requisição, prepare o receptor do evento ou consulte o esquema dos modelos.

Criar a mensagem a partir do seu sistema

Consulte o esquema de mensagens e teste a requisição com uma conta preparada no testador da API.

Abrir o testador da API

Receber o que acontece no WhatsApp

Prepare seu receptor HTTPS, selecione os eventos e trate as novas tentativas antes de usá-lo em produção.

Consultar o guia de webhooks

Revisar os modelos da conta

Consulte os modelos aprovados e os formatos de envio com seu idioma e variáveis.

Abrir a documentação da API

Prefere preparar um percurso visual?

O Flows reúne passos e conexões que você precisa configurar e testar. O servidor MCP permite pedir tarefas de um cliente autorizado como ChatGPT ou Claude.

Veja o Flows Veja o servidor MCP

Uma chave. Um número. Um teste.

Mantenha as credenciais no servidor e confira a operação antes de conectá-la ao trabalho real.

Crie e proteja sua chave
Use uma chave autorizada para sua conta. Guarde-a no servidor e confira seu acesso antes de compartilhar uma integração.
Confira o número
Verifique se o número está operacional e se sua conta tem acesso e capacidade para a operação.
Teste requisições e eventos
Consulte o esquema, faça uma requisição de teste e valide a resposta. Se usar webhooks, prepare o receptor e o tratamento de novas tentativas.

Antes de começar

Uma conta autorizada e um número operacional.
Credenciais protegidas no servidor; os exemplos não incluem uma chave real.
Permissão do destinatário e modelos aprovados quando o envio exigir.
Um receptor HTTPS e tratamento de novas tentativas se usar webhooks.

Começar grátis Ver planos e condições

Antes de conectar seu sistema.

Um 201 significa que a mensagem chegou?

O 201 confirma que a mensagem foi criada. Consulte seu estado e os eventos disponíveis para acompanhar sua evolução; não use como prova de entrega ou leitura.

Posso colocar minha chave na página web?

Mantenha a chave no servidor. Evite expô-la no navegador, em repositórios públicos ou exemplos compartilhados.

Quando preciso de um modelo aprovado?

Quando as regras do WhatsApp exigirem, como em mensagens proativas fora da janela de atendimento. Consulte os requisitos e o formato de envio na documentação.

Prepare o aviso de que seu sistema precisa.

Começar grátis

Crie sua conta, confira o acesso e consulte a documentação para testar a operação.