API REST · WhatsApp Cloud API

Leve a WhatsApp Cloud API para o seu sistema.

Camada HTTP entre o seu backend e a Meta. Sem CRM e sem chatbot próprio: gere a chave e implemente no n8n, Typebot, Make ou no código que já tem.

A PliVant cobra o acesso por número em assinatura mensal recorrente no cartão (a partir de R$ 45,90/mês). As cobranças de uso da WhatsApp Business Platform, quando aplicáveis, seguem a tabela vigente da Meta e ficam na sua própria conta Meta — sem markup da PliVant.

Contratar número e gerar chave Documentação

Fora da janela de 24h · template aprovado pela Meta

curl -X POST https://api.plivant.com.br/v1/messages \
  -H "Authorization: Bearer plv_live_SUA_CHAVE" \
  -H "Idempotency-Key: pedido-123" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "5511999998888",
    "type": "template",
    "templateName": "pedido_confirmado",
    "languageCode": "pt_BR",
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "Ana" },
          { "type": "text", "text": "4821" }
        ]
      }
    ]
  }'

Três passos para o primeiro 202

Pague o número e conecte o WhatsApp

Assinatura recorrente no cartão a partir de R$ 45,90/mês por número. Embedded Signup oficial. O app continua no celular.

Gere a chave plv_live_

A chave já nasce vinculada ao projeto. Só o header Authorization: Bearer.

POST /v1/messages

A API responde 202 com o id. Texto livre só na janela de 24h; fora dela, use template aprovado.

Dois custos, duas contas

PliVant: assinatura mensal no cartão por número, com projetos, chave e webhook — a partir de R$ 45,90.
Meta: uso da WhatsApp Business Platform na sua própria conta Meta. Cadastre cartão ou crédito no Business Manager para as cobranças aplicáveis de mensagens, conforme a tabela vigente da Meta.

Ver preço por número

Janela de 24 horas

Texto livre e mídia só depois que o contato escreveu nas últimas 24h. Lead frio ou campanha: template com status APPROVED na Meta. Sem isso a API devolve o erro 131047.

Contrato da API

URL base https://api.plivant.com.br/v1
Authorization: Bearer plv_live_… — a chave já está no projeto
Idempotency-Key em todo envio (mesmo payload devolve o mesmo id; payload diferente retorna 409)
POST /v1/messages responde 202 com { id, status: "queued", recipient, type, metadata?, tags?, created_at }
Envie texto, imagem, vídeo, áudio, documento, sticker, template, botões, listas, contato, localização e reação
Marque inbound como lido e, se quiser, ative o indicador “digitando…” oficial da Meta na mesma operação
GET /v1/messages/:id consulta o status (sent, delivered, read, failed)
Headers X-RateLimit-Limit, Remaining e Reset em toda resposta autenticada
Webhooks HMAC-SHA256 para inbound e status — com múltiplos endpoints por projeto e filtros de evento
Isolamento multi-tenant por organização, projeto, número, chave e permissões
Telefone só dígitos E.164, ex: 5511999998888

Documentação da API Contrato de webhooks Exemplos em cURL, Node, Python e PHP

202 Accepted

{
  "id": "c3f1a8e2-7b14-4d90-9c2a-1f6e8b0d4a21",
  "status": "queued",
  "recipient": "5511999998888",
  "type": "text",
  "metadata": {
    "order_id": "ord_123",
    "customer_id": "crm_42"
  },
  "tags": [
    "ecommerce",
    "checkout"
  ],
  "created_at": "2026-09-20T01:30:00.000Z"
}

Consultar status

curl https://api.plivant.com.br/v1/messages/<MESSAGE_ID> \
  -H "Authorization: Bearer plv_live_SUA_CHAVE"

Onde implementar

Chatwoot é integração nativa. Para n8n, Typebot, Make, CRMs e plataformas de pagamento, a PliVant entrega receitas HTTP/webhook prontas, sem fingir que são conectores OAuth oficiais.

Backend próprio

Node, Python, PHP, Go — um POST com Bearer.

Chatwoot nativo

Conecte a Inbox API e use o Chatwoot como atendimento sem transformar a PliVant em CRM.

n8n

Importe o workflow JSON. Só a env PLIVANT_API_KEY.

Typebot / Make

Bloco Webhook / HTTP Request com o mesmo payload.

CRM / pagamentos

HubSpot, RD, Pipedrive, Kiwify, Hotmart via HTTP.

Contratar a partir de R$ 45,90