Como podemos ajudar?

O Vectalk é uma plataforma de acesso à API oficial do WhatsApp Business (WhatsApp Business Platform), da Meta, da qual somos Meta Business Partner. Você integra o WhatsApp ao seu CRM, ERP, chatbot, e-commerce ou SaaS por meio de uma API REST e recebe os eventos (mensagens recebidas, status de entrega e leitura) via webhooks.

• Uma conta no Vectalk (cadastre-se aqui).
• Um portfólio empresarial na Meta (Meta Business) com os dados da sua empresa.
• Um número de telefone que possa receber o código de verificação por SMS ou ligação e que será dedicado à API.
• Um sistema capaz de chamar uma API REST e expor um endpoint HTTPS para receber webhooks.

O fluxo geral é: conectar o número à conta, gerar as credenciais de acesso, cadastrar um template (necessário para iniciar conversas) e fazer a chamada de envio pela API. Como a primeira mensagem para um contato normalmente acontece fora da janela de 24 horas, ela precisa ser um template aprovado. O passo a passo com endpoints e exemplos de requisição está na documentação.

O Vectalk é pensado para quem integra via código: a comunicação acontece por API REST e webhooks. Se sua equipe não tem desenvolvedores, você pode contar com um parceiro de integração ou falar com a nossa equipe para entender o melhor caminho.

Há duas partes distintas: o plano do Vectalk, pelo uso da plataforma, e as tarifas da Meta pelas mensagens enviadas pela WhatsApp Business Platform. As tarifas da Meta variam conforme a categoria da mensagem (marketing, utilidade, autenticação) e o país do destinatário, e são definidas e atualizadas pela própria Meta. Para condições comerciais do Vectalk, fale com a nossa equipe.

No modelo de cobrança vigente da Meta, as mensagens de serviço (respostas livres, sem template, enviadas dentro da janela de atendimento) não são cobradas pela Meta. A cobrança recai principalmente sobre mensagens de template. Como a Meta revisa suas regras de preço periodicamente, confirme sempre na tabela oficial de preços da WhatsApp Business Platform.

Acesse sua conta em apps.vectalk.com.br ou entre em contato pela nossa página de contato informando o e-mail da conta e o que precisa ajustar.

Em geral, um número registrado na API não pode continuar sendo usado ao mesmo tempo no aplicativo comum do WhatsApp. Se o número já estiver em uso no app, será preciso migrá-lo (o que implica deixar de usá-lo no aplicativo) ou avaliar as opções que a Meta oferece para números do WhatsApp Business app. Antes de migrar um número importante, fale com a gente para planejar a troca sem interromper o atendimento.

É o processo em que a Meta confirma que o portfólio empresarial pertence a uma empresa real, a partir de documentos e dados como razão social, CNPJ, endereço, site e domínio. A verificação é um passo importante para ampliar limites de envio e para outras solicitações junto à Meta. Mantenha os dados do portfólio idênticos aos dos documentos para evitar reprovação.

O nome de exibição (display name) é o nome que aparece para o cliente e passa por revisão da Meta. Ele precisa ter relação clara com a sua marca ou empresa, seguindo as diretrizes da Meta (sem termos genéricos isolados, sem uso indevido de marcas de terceiros). Nomes reprovados podem ser ajustados e reenviados.

A Meta atribui ao número uma classificação de qualidade (alta, média ou baixa) com base no retorno dos usuários, como bloqueios e denúncias, nas mensagens recentes. Qualidade baixa pode restringir o envio e impedir o aumento dos limites. Para manter a qualidade: envie apenas para quem deu opt-in, seja relevante, respeite pedidos de saída e evite volume alto de marketing para bases frias.

Sim. A Meta define limites de mensagens iniciadas pela empresa (templates) para destinatários únicos em um período de 24 horas, organizados em níveis. O nível sobe conforme o número mantém boa qualidade e volume de envio, e a verificação do negócio costuma ser exigida para ampliar o limite inicial. Os valores de cada nível são definidos pela Meta e podem mudar; consulte o status atual do seu número no gerenciador da Meta.

Sempre que um cliente envia uma mensagem para o seu número, abre-se (ou é renovada) uma janela de 24 horas. Dentro dela, você pode responder com mensagens livres: texto, mídia, botões interativos. Fora dela, só é possível iniciar contato com um template aprovado pela Meta. Veja o guia Templates e janela de 24 horas.

É um modelo de mensagem pré-aprovado pela Meta, composto por cabeçalho (opcional), corpo, rodapé (opcional) e botões (opcionais), com variáveis que você preenche no envio, como nome do cliente ou número do pedido. Templates são obrigatórios para iniciar conversas fora da janela de 24 horas.

• Marketing: promoções, ofertas, novidades, reengajamento.
• Utilidade: atualizações sobre uma transação ou solicitação do cliente, como confirmação de pedido, status de entrega ou lembrete de pagamento.
• Autenticação: códigos de verificação de uso único (OTP).

Além delas, há as mensagens de serviço: respostas livres dentro da janela aberta pelo cliente. A categoria influencia o preço e a Meta pode reclassificar um template que não corresponda à categoria declarada.

Motivos frequentes: categoria incompatível com o conteúdo (ex.: promoção enviada como utilidade), variáveis mal formatadas ou no início/fim do texto sem contexto, conteúdo que viola as políticas comerciais do WhatsApp, texto vago que não deixa claro o propósito ou links encurtados suspeitos. Revise o conteúdo, ajuste e envie novamente.

Sim. Templates aceitam cabeçalho com imagem, vídeo ou documento e botões (resposta rápida, link, telefone, entre outros). Dentro da janela de 24 horas, também é possível enviar mensagens interativas livres, como listas e botões de resposta. Formatos, limites de tamanho e parâmetros exatos estão na documentação.

Eventos como mensagens recebidas dos clientes e atualizações de status das mensagens enviadas (enviada, entregue, lida, falha), além de outras notificações da conta. A estrutura exata dos payloads e a configuração da URL estão descritas na documentação.

Entregas de webhook seguem o modelo "pelo menos uma vez": se o seu endpoint demora ou falha, o evento é reenviado. Por isso, trate o processamento como idempotente, usando o ID da mensagem ou do evento para descartar duplicatas. Detalhamos isso no artigo Webhooks do WhatsApp: como receber eventos de forma confiável.

Não há garantia de ordem. Um status "lida" pode chegar antes de "entregue", por exemplo. Use o timestamp do evento e regras de progressão de status (nunca regredir de "lida" para "entregue") em vez de confiar na ordem de chegada.

Eventos não confirmados são reenviados por um período limitado, mas não indefinidamente. Responda rápido com HTTP 200, processe de forma assíncrona em uma fila e monitore erros e latência do endpoint para não perder eventos em uma indisponibilidade prolongada.

Opt-in é o consentimento do cliente para receber mensagens da sua empresa pelo WhatsApp. As políticas do WhatsApp exigem que ele seja coletado antes de você iniciar contato, deixando claro que as mensagens virão pelo WhatsApp e em nome de qual empresa. Guarde o registro de quando e como o opt-in foi obtido: ele ajuda em auditorias e na conformidade com a LGPD.

Respeite imediatamente qualquer pedido para parar de receber mensagens, seja por texto livre ("parar", "sair") ou por botão de template. Registre o opt-out no seu sistema e bloqueie novos envios de marketing para aquele contato. Ignorar pedidos de saída gera bloqueios e denúncias, que derrubam a qualidade do número.

• Guarde tokens e segredos em variáveis de ambiente ou em um cofre de segredos, nunca no código-fonte ou no front-end.
• Faça chamadas à API somente a partir do seu back-end.
• Rotacione credenciais periodicamente e sempre que houver suspeita de vazamento.
• Valide a autenticidade dos webhooks recebidos conforme descrito na documentação.

Sua empresa continua sendo responsável pelos dados pessoais que coleta e trata nas conversas. Defina a base legal de cada uso, colete apenas o necessário, estabeleça prazos de retenção para mensagens e mídias armazenadas no seu sistema e garanta os direitos do titular (acesso, correção, exclusão). Consulte também a nossa Política de Privacidade.