WhatsApp Business API: configuração e perguntas frequentes

Entenda os requisitos, a janela de atendimento e as limitações atuais de envio.

A integração Klyro com o WhatsApp Business API permite que vários atendentes trabalhem no mesmo número, com histórico centralizado na Inbox e conversas vinculadas aos contatos.

O WhatsApp Business API é indicado para sua empresa?

Use a API quando sua operação precisar de atendimento em equipe, automações e integração com sistemas. Ela é diferente do aplicativo pessoal e foi projetada para operações empresariais.

Diferenças principais

  • WhatsApp pessoal: comunicação individual do dia a dia.

  • WhatsApp Business App: aplicativo gratuito para pequenos negócios e operação manual.

  • WhatsApp Business API: infraestrutura empresarial para múltiplos atendentes, integrações e maior escala.

Requisitos para conectar

  • Uma conta empresarial na Meta com acesso administrativo.

  • Uma Conta do WhatsApp Business (WABA), existente ou criada durante a configuração.

  • Um número de telefone apto a ser registrado ou migrado conforme as regras apresentadas pela Meta.

  • Permissão para aceitar os termos e concluir a verificação solicitada no fluxo.

Como conectar na Klyro

  1. Acesse Administração → Canais.

  2. Escolha WhatsApp Oficial e dê um nome ao canal.

  3. Continue a configuração na nova aba aberta pela Klyro.

  4. Entre na conta Meta correta, selecione ou crie a WABA e escolha o número.

  5. Conclua a autorização e retorne à lista de canais.

  6. Verifique se o status está como Conectado.

Como funciona a janela de 24 horas?

Quando o cliente envia uma mensagem, inicia-se uma janela de atendimento de 24 horas. Dentro dela, a equipe pode responder livremente. Depois do encerramento da janela, uma nova mensagem proativa deve usar um modelo aprovado pela Meta.

Limitação atual: o envio de modelos aprovados ainda não está disponível na Klyro. Fora da janela de 24 horas, aguarde uma nova mensagem do cliente para responder. Criar uma conversa pela tela de Contatos não abre essa janela.

Perguntas frequentes

Posso usar um único número com vários atendentes?

Sim. As conversas entram na Inbox e podem ser assumidas, atribuídas e tratadas por usuários autorizados.

Posso iniciar uma conversa com um contato?

A Klyro pode criar ou retomar a conversa quando o contato possui telefone válido e o canal está conectado. Porém, o primeiro envio fica bloqueado se não houver uma janela de atendimento ativa, pois o envio de modelos ainda não está disponível.

Quais mídias podem ser enviadas?

A Klyro suporta texto e anexos compatíveis com o canal, incluindo imagens, vídeos, documentos e áudio. O WhatsApp aplica limites próprios de formato e tamanho, e arquivos incompatíveis podem falhar no envio.

Por que o canal pede reconexão?

Isso pode ocorrer quando a autorização expira, permissões são removidas ou a conta empresarial muda. Reconecte usando um administrador da conta Meta.

O histórico anterior é importado?

A Klyro registra as mensagens processadas após a conexão. Não conte com a importação automática de todo o histórico anterior do aplicativo.

Boas práticas e conformidade

  • Obtenha consentimento antes de enviar mensagens proativas.

  • Ofereça uma forma clara de descadastro.

  • Use modelos úteis, esperados e coerentes com a finalidade aprovada.

  • Evite spam e monitore bloqueios, denúncias e qualidade do número.

  • Mantenha os dados do contato atualizados e restrinja o acesso administrativo.