Guia Completo de Integracao com a WhatsApp Business API

A WhatsApp Business API permite que empresas conversem com clientes em escala. Com a Zavu, voce integra o WhatsApp e outros canais usando uma unica API e mantem toda a jornada sincronizada.

Por que Usar a WhatsApp API?

98% de taxa de abertura contra ~20% do email
Suporte a midia rica (imagens, documentos, botoes interativos)
Criptografia ponta a ponta
Alcance global em mais de 180 paises

Configurando WhatsApp na Zavu

Passo 1: Verificacao do Negocio

Verifique a empresa junto a Meta:

typescript
const status = await zavu.whatsapp.getVerificationStatus()

console.log('Business Name:', status.businessName)
console.log('Verification Status:', status.verified)
console.log('Quality Rating:', status.qualityRating)

Passo 2: Templates

WhatsApp exige templates aprovados para mensagens proativas:

typescript
const template = await zavu.whatsapp.templates.create({
  name: 'order_confirmation',
  language: 'pt_BR',
  category: 'TRANSACTIONAL',
  components: [
    {
      type: 'HEADER',
      format: 'TEXT',
      text: 'Pedido confirmado!'
    },
    {
      type: 'BODY',
      text: 'Ola {{1}}, seu pedido #{{2}} foi confirmado. Entrega prevista: {{3}}.'
    },
    {
      type: 'FOOTER',
      text: 'Responda AJUDA para suporte'
    },
    {
      type: 'BUTTONS',
      buttons: [
        { type: 'URL', text: 'Acompanhar pedido', url: 'https://track.example.com/{{1}}' },
        { type: 'QUICK_REPLY', text: 'Falar com suporte' }
      ]
    }
  ]
})

Passo 3: Envio de Templates

Depois de aprovado, envie o template:

typescript
const message = await zavu.whatsapp.sendTemplate({
  to: '+1234567890',
  template: 'order_confirmation',
  parameters: {
    body: ['Joao', 'ORD-12345', '20 de janeiro de 2025']
  }
})

Mensagens Interativas

WhatsApp aceita listas e botoes dinamicos:

typescript
await zavu.whatsapp.sendInteractive({
  to: '+1234567890',
  type: 'list',
  header: { type: 'text', text: 'Escolha uma opcao' },
  body: { text: 'Como podemos ajudar hoje?' },
  action: {
    button: 'Ver opcoes',
    sections: [
      {
        title: 'Suporte',
        rows: [
          { id: 'track_order', title: 'Acompanhar pedido' },
          { id: 'return_item', title: 'Solicitar devolucao' },
          { id: 'speak_agent', title: 'Falar com atendente' }
        ]
      }
    ]
  }
})

Boas Praticas

Respeite o opt-in — so envie para quem autorizou

Templates objetivos — mensagens curtas e claras

Monitore o quality rating — baixa qualidade gera bloqueios

Respostas rapidas — usuarios esperam retorno quase imediato

Limites e Precos

Tier	Mensagens/dia	Preco/mensagem

Standard	1.000	$0.005
Business	10.000	$0.004
Enterprise	Ilimitado	Sob consulta

Fale com vendas para planos Enterprise.Pronto para integrar? Comece gratis ou fale conosco. Entre na comunidade do Discord para suporte.