Integrar WhatsApp com WooCommerce

Passo a passo

1. 1

   Conecte um número na ZapZap API

   No painel da ZapZap API, crie uma instância e leia o QR Code com o WhatsApp do número que vai enviar as notificações da loja. Guarde o instanceId, o x-api-key e o x-api-secret, que serão usados nas chamadas HTTP.

2. 2

   Ative os webhooks no WooCommerce

   No painel do WordPress, vá em WooCommerce > Configurações > Avançado > Webhooks e clique em Adicionar webhook. Dê um nome como Notifica WhatsApp e deixe o status como Ativo.

3. 3

   Configure o tópico e a URL de entrega

   Em Tópico, escolha Pedido criado e Pedido atualizado (crie um webhook para cada). No campo URL de entrega, informe o endereço do seu backend que vai receber o payload do pedido, por exemplo https://seu-servidor.com/woo/pedido. Defina um Segredo para validar a assinatura X-WC-Webhook-Signature.

4. 4

   Trate o payload e dispare a mensagem

   No seu backend, leia o JSON do pedido enviado pelo WooCommerce (billing.phone, status, line_items) e monte o texto da notificação conforme o status. Em seguida faça uma requisição para a ZapZap API enviando a mensagem para o número do cliente pela sua instância.

5. 5

   Teste com um pedido real

   Faça um pedido de teste na loja, aprove o pagamento e mude o status para concluído. Confira se chegou a mensagem de confirmação, de pagamento e de envio. Use o crédito grátis para validar todo o fluxo antes de escalar.

// ILUSTRATIVO : confira os endpoints reais em https://api.zapzapapi.com/llms.txt
// Backend que recebe o webhook do WooCommerce e notifica o cliente no WhatsApp

app.post('/woo/pedido', async (req, res) => {
  const pedido = req.body; // payload do WooCommerce
  const telefone = pedido.billing.phone.replace(/\D/g, '');

  const textos = {
    'pending':    `Recebemos seu pedido #${pedido.number}. Aguardando pagamento.`,
    'processing': `Pagamento aprovado do pedido #${pedido.number}. Já estamos separando seus itens.`,
    'completed':  `Seu pedido #${pedido.number} foi enviado. Obrigado pela compra!`
  };

  const text = textos[pedido.status];
  if (!text) return res.sendStatus(200);

  const instanceId = 'SUA_INSTANCIA';

  await fetch(`https://api.zapzapapi.com/api/v1/${instanceId}/send/text`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': process.env.ZAPZAP_API_KEY,
      'x-api-secret': process.env.ZAPZAP_API_SECRET
    },
    body: JSON.stringify({ number: `55${telefone}`, text })
  });

  res.sendStatus(200);
});