Skip to main content

​
Visão Geral

O Kinbox oferece suporte a duas modalidades de integração com o WhatsApp:
  1. WhatsApp Oficial (Cloud API) - API oficial do Meta Business
  2. WhatsApp Não-Oficial - Conexão direta via QR Code
Cada modalidade tem suas vantagens e limitações. Escolha a que melhor se adequa às necessidades do seu negócio.

​
WhatsApp Oficial (Cloud API)

​
Requisitos

  • Conta no Meta Business Manager
  • Número de telefone verificado
  • Documentação da empresa aprovada pelo Meta

​
Vantagens

Estabilidade e confiabilidade garantidas pelo Meta
Suporte a templates de mensagens pré-aprovados
Ideal para alto volume de mensagens
Suporte a campanhas em massa
Webhooks oficiais para receber mensagens

​
Limitações

Mensagens proativas requerem templates pré-aprovados
Processo de aprovação pode levar alguns dias
Custos por mensagem dependem do país de destino

​
Configuração do WhatsApp Oficial

1

Acesse o Meta Business Manager

Crie ou acesse sua conta no Meta Business Manager.
2

Configure o WhatsApp Business API

No painel do Meta Business, navegue até a seção de WhatsApp e configure sua conta Business API.
3

Obtenha suas credenciais

Anote as seguintes informações:
  • Phone Number ID
  • Business Account ID
  • Access Token
  • Webhook Verify Token
4

Configure no Kinbox

No painel do Kinbox:
  1. Vá em Configurações > Canais
  2. Clique em Adicionar Canal
  3. Selecione WhatsApp Oficial
  4. Insira suas credenciais
5

Configure o Webhook

No Meta Business Manager, configure a URL de webhook fornecida pelo Kinbox:
https://api4.kinbox.com.br/v3/webhooks/whatsapp/official
Selecione os eventos:
  • messages
  • message_status
  • messaging_postbacks
6

Teste a conexão

Envie uma mensagem de teste para o número configurado e verifique se aparece no Kinbox.

​
Recursos Disponíveis

​
Templates de Mensagens

Crie e gerencie templates pré-aprovados para iniciar conversas com clientes:
  • Templates de marketing
  • Templates de serviço
  • Templates de autenticação
Templates precisam ser aprovados pelo Meta antes de serem usados. O processo geralmente leva 24-48 horas.

​
Campanhas em Massa

O WhatsApp Oficial suporta o envio de campanhas para múltiplos contatos:
  • Envie templates aprovados para sua base de contatos
  • Acompanhe estatísticas de entrega e leitura
  • Respeite horários comerciais automaticamente

​
Catálogo de Produtos

O Kinbox suporta mensagens de catálogo do WhatsApp, permitindo que clientes vejam seus produtos diretamente no chat.

​
WhatsApp Não-Oficial

​
Visão Geral

A versão não-oficial conecta diretamente ao WhatsApp usando QR Code, similar ao WhatsApp Web.

​
Vantagens

Configuração rápida e simples
Sem necessidade de aprovação do Meta
Sem custos por mensagem
Envio de mensagens proativas sem restrições

​
Limitações

Contra os termos de serviço do WhatsApp - risco de banimento
Menos estável que a versão oficial
Não recomendado para alto volume

​
Configuração do WhatsApp Não-Oficial

1

Prepare um número

Tenha um número de telefone com WhatsApp ativo. Recomendamos usar um número dedicado para o atendimento.
2

Crie o canal no Kinbox

  1. Vá em Configurações > Canais
  2. Clique em Adicionar Canal
  3. Selecione WhatsApp Não-Oficial
  4. Dê um nome para o canal
3

Leia o QR Code

  1. No Kinbox, clique em Conectar Canal
  2. Um QR Code será exibido
  3. No seu celular, abra o WhatsApp
  4. Vá em Configurações > Aparelhos Conectados
  5. Clique em Conectar Aparelho
  6. Escaneie o QR Code exibido no Kinbox
4

Confirme a conexão

Após escanear o QR Code, o canal ficará conectado automaticamente.
Canais não-oficiais recriados não exigem nova leitura de QR Code - o sistema reutiliza a sessão anterior automaticamente.

​
Recursos Comuns

​
Mensagens Suportadas

Ambas as versões suportam:
  • Texto
  • Imagens
  • Vídeos
  • Áudios
  • Documentos
  • Localização
  • Contatos
  • Stickers
  • Reações (WhatsApp Lite)

​
Formatação de Texto

O Kinbox preserva a formatação do WhatsApp: 
*Negrito*
_Itálico_
~Riscado~

​
Grupos do WhatsApp

O Kinbox suporta conversas em grupos do WhatsApp:
  • Visualize todas as mensagens do grupo
  • Inicie conversas privadas com membros do grupo
  • Configure bots para responder em grupos
Para iniciar uma conversa privada com um membro do grupo, clique nos 3 pontos na mensagem dele e selecione “Iniciar conversa”.

​
Configurações Avançadas

​
Atribuição Automática

Configure regras para distribuir conversas automaticamente entre operadores quando uma nova mensagem chegar pelo WhatsApp.

​
Bot para WhatsApp

Crie fluxos de bot específicos para o WhatsApp:
  • Responda automaticamente fora do horário comercial
  • Qualifique leads antes de atribuir a um operador
  • Colete informações de contato
  • Integre com CRM

​
Horário Comercial

Defina quando o bot deve estar ativo e quando as conversas devem ser atribuídas a operadores humanos.

​
Restringir Visibilidade

Limite quais grupos de operadores podem ver conversas de canais específicos do WhatsApp.

​
Campanhas de WhatsApp

​
WhatsApp Oficial

Para canais oficiais, você pode criar campanhas usando templates aprovados:
1

Crie um template

No Meta Business Manager, crie e aguarde aprovação de um template.
2

Configure a campanha

No Kinbox, vá em Campanhas > Nova Campanha
3

Selecione o template

Escolha o template aprovado e preencha os placeholders
4

Importe contatos

Faça upload de um arquivo com os números de telefone
5

Configure envio

Defina horários e limite de envios por lote
6

Acompanhe resultados

Monitore estatísticas de entrega, leitura e resposta

​
WhatsApp Não-Oficial

Canais não-oficiais também suportam campanhas, mas com mensagens livres (sem necessidade de templates).
O uso excessivo de campanhas em canais não-oficiais pode aumentar o risco de banimento.

​
Detecção de Problemas

O Kinbox monitora automaticamente a saúde dos canais do WhatsApp:
  • Canal Desconectado: Necessário reconectar
  • Canal Banido: WhatsApp bloqueou o número
  • Erro de Envio: Problemas temporários de conexão
Quando um problema é detectado, você receberá uma notificação automática no painel.

​
Melhores Práticas

​
Para WhatsApp Oficial

  1. Use templates aprovados: Sempre utilize templates pré-aprovados para mensagens proativas
  2. Respeite opt-in: Só envie mensagens para contatos que consentiram
  3. Monitore custos: Acompanhe os custos por mensagem no Meta Business
  4. Prepare templates diversos: Tenha templates para diferentes cenários

​
Para WhatsApp Não-Oficial

  1. Use com moderação: Evite alto volume de mensagens
  2. Número dedicado: Use um número específico para o atendimento
  3. Evite spam: Não envie mensagens em massa frequentemente
  4. Tenha backup: Mantenha o WhatsApp Oficial como alternativa

​
Integração com Bot

Configure o bot para funcionar em todos os canais do WhatsApp:
  1. Vá em Configurações > Bot
  2. Edite seu bot
  3. Nas configurações, ative “Bot para todos os canais”
  4. Configure decisões específicas por canal, se necessário

​
Integrações CRM

O Kinbox pode criar e atualizar contatos automaticamente em:
  • HubSpot
  • RD Station
  • Bitrix24
  • Zoho CRM
  • Integrações personalizadas via webhook

​
Troubleshooting

​
Canal não conecta

  1. Verifique se o webhook está configurado corretamente no Meta Business
  2. Confirme que o token de acesso está válido
  3. Verifique se o número está aprovado para envio
  1. Verifique sua conexão de internet
  2. Tente recriar o canal
  3. Verifique se o número não foi banido
  4. Use um número diferente se necessário
  1. Verifique o status do canal
  2. Para oficial: confirme que o template está aprovado
  3. Verifique se há créditos disponíveis (para oficial)
  4. Consulte os logs de erro no painel

​
Próximos Passos

Configure Automações

Crie bots para o WhatsApp

Crie Campanhas

Envie mensagens em massa

Build docs developers (and LLMs) love

Get started for freeTalk to us