Conectar o WhatsApp da loja

Quando usar

Conecte o WhatsApp quando quiser avisar o cliente a cada mudança de rastreio, disparar o ciclo de vida do pedido ou receber as conversas no Atendimento.

Quem pode fazer

Qualquer membro do time conecta o número e edita templates, desde que o plano da empresa inclua a integração WhatsApp. Sem o recurso no plano, a tela explica o bloqueio e aponta para Plano e cobrança.

Pré-requisitos

• Plano com WhatsApp habilitado.
• WhatsApp Web: o celular da loja, com internet, para escanear o QR code.
• WhatsApp Business (API oficial): conta Meta Business e um número aprovado na Cloud API.

Passo a passo

1. 1. Abra WhatsApp. No menu Comunicação → WhatsApp a tela abre na aba Visão geral, com as abas Conexão, Rastreio, Pedidos e Histórico. Se o plano não incluir o recurso, você verá o aviso e o atalho para o plano da empresa.

   

2. 2. Confira o canal conectado. Na aba Conexão o card WhatsApp Web (Evolution) mostra se o envio vai pelo QR no celular (texto livre, limite diário aproximado) ou pelo WhatsApp Business (API oficial da Meta, templates aprovados). Use Desconectar Web só quando for trocar o número ou o modo.

   

3. 3. Confirme o número. No Web, escaneie o QR na aba Conexão até o status Conectado e o número aparecer no card. No Business, conclua o vínculo da conta Meta. A visão geral resume o modo, o número e o volume aproximado de mensagens.

   

4. 4. Revise os avisos automáticos. Na aba Rastreio (e em Pedidos) ligue o envio automático dos eventos que a loja deve avisar. Na Cloud API, mapeie cada evento a um modelo oficial aprovado — fora da janela de 24 horas o WhatsApp exige esse modelo.

   

Resultado esperado

A sessão aparece como Conectado. Os avisos configurados saem quando o rastreio muda. Conversas entram no Atendimento. A API de status e envio passa a responder para o time.

Erros comuns

• Recurso indisponível. O plano não inclui WhatsApp. Abra Plano e cobrança.
• QR expirado (Web). Gere outro código e mantenha o celular online.
• Envio Cloud recusado fora da janela de 24h. Associe um template oficial aprovado ao evento. Detalhe na seção Cloud API abaixo.

Relacionados

• Atender clientes no inbox
• Criar chaves de API
• NPS por WhatsApp

Caminho no painel: Dashboard → WhatsApp. Contrato HTTP a seguir.

atualizadoEm

2026-08-20

superficie

dashboard

owner

Technical Writer

printsGeradosEm

2026-08-20

Visão Geral

Com a integração WhatsApp você pode:

• Verificar o status da conexão do seu número.
• Enviar o último status de rastreio de um pedido manualmente.
• As notificações automáticas são disparadas a cada mudança de evento Correios (configurável no dashboard).

Status da Conexão

Retorna o status atual da integração WhatsApp do seu time.

Resposta

{
  "ok": true,
  "status": "connected",
  "provider": "cloud",
  "phoneNumber": "5511999999999",
  "lastConnectedAt": "2026-04-19T10:00:00.000Z"
}

O campo status pode ser: connected, disconnected, connecting ou not_configured.

O campo provider indica o provedor ativo do time: web (WhatsApp Web/Evolution) ou cloud (WhatsApp Business Cloud API oficial).

Enviar Mensagem

Envia o último status de rastreio de um pedido via WhatsApp para o número cadastrado no pedido (ou um número informado no body).

Body (JSON)

Resposta de Sucesso (200)

{
  "ok": true,
  "messageId": "3EB0796DC3B64F123456"
}

Erros comuns

• 401 unauthorized — Chave de API inválida.
• 403 plan_limit — Recurso não disponível no plano.
• 404 not_found — Pedido não encontrado.
• 422 not_connected — WhatsApp desconectado. Reconecte no dashboard.
• 422 no_phone — Pedido sem telefone; forneça o campo phone.

Exemplos

cURL

# Status da conexão
curl "https://seurastreio.com.br/api/public/whatsapp/status" \
  -H "Authorization: Bearer sr_live_sua_chave_aqui"

# Enviar mensagem
curl -X POST "https://seurastreio.com.br/api/public/whatsapp/enviar" \
  -H "Authorization: Bearer sr_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{"orderId": "ord_123456"}'

JavaScript

const res = await fetch("https://seurastreio.com.br/api/public/whatsapp/enviar", {
  method: "POST",
  headers: {
    Authorization: "Bearer sr_live_sua_chave_aqui",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ orderId: "ord_123456" }),
});
const data = await res.json();
console.log(data.ok, data.messageId);

Templates de Mensagem

As mensagens são geradas a partir de templates configuráveis no Dashboard → WhatsApp. As variáveis disponíveis são:

Cloud API: janela de 24h e templates oficiais

Na integração oficial (Cloud API), mensagens “livres” só podem ser enviadas dentro da janela de 24h após o cliente enviar uma mensagem para a empresa. Fora dessa janela, o WhatsApp exige envio via template oficial aprovado.

No dashboard você pode mapear cada evento (ex.: “Saiu para entrega”) para um template oficial aprovado. Se não houver mapeamento, o envio fora da janela de 24h pode falhar.