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.

Os números da visão geral

Os três cartões do topo contam o time inteiro e não mudam com os filtros da aba Histórico:

• Envios registrados — todas as mensagens já disparadas pela integração, de qualquer origem (pedido, etapa do pedido ou rastreio), desde o início.
• Números inválidos — envios cujo destino o WhatsApp não reconheceu. Fica vermelho quando há pelo menos um; a aba Histórico permite filtrar só esses.
• Eventos ativos — de 12 eventos possíveis, quantos estão prontos para disparar. No WhatsApp Web isso quer dizer envio habilitado; na Cloud API, template mapeado. Fica âmbar em zero, porque conectar sem ativar nenhum evento não envia nada.

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. O estado da sessão fica em uma pílula ao lado do título — ela acompanha você em qualquer aba, então dá para ver que o canal caiu sem voltar para a Visão geral. 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, use Criar os 6 modelos na Metapara enviar os textos prontos (categoria Utilidade) de uma vez. O painel mostra quantos já foram aprovados e quais ainda estão em revisão. Se você já criou os modelos no Gerenciador da Meta, sincronize e vincule cada um ao evento. Fora da janela de 24 horas o WhatsApp exige esse modelo oficial.

   

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
• E-mails automáticos de pedido e rastreio
• Criar chaves de API
• NPS por WhatsApp

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

atualizadoEm

2026-09-18

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.
• 402 subscription_required — Assinatura atrasada, cancelada ou inexistente.
• 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ê cria os modelos oficiais em lote: Criar os 6 modelos na Meta(rastreio ou pedidos). O painel mostra quantos já foram aprovados e quais ainda estão em revisão ou recusados. Se você já criou os modelos no Gerenciador da Meta, sincronize o catálogo e vincule cada um ao evento. Sem mapeamento aprovado, o envio fora da janela de 24h pode falhar.

Nos avisos automáticos de pedido e rastreio, o campo de “última atualização” / “resumo do rastreio” precisa estar ligado à variável status (o texto do evento), não ao código de rastreio. Sem isso o cliente recebe sempre o mesmo código e acha que nada mudou.