WhatsApp Integração com LenoChat

Pré-requisitos Antes de Começar

Antes de poder conectar WhatsApp a LenoChat, você precisa de algumas coisas definidas. Esses são requisitos impostos pela Meta (a empresa por trás da WhatsApp) e não pela LenoChat, então você deve tê-los prontos antes de começar a configuração.

• Uma conta Facebook Business Manager — você deve ter acesso de administrador ao Business Manager que será dono da WhatsApp Conta Empresarial. Se sua empresa ainda não tem uma conta de Gerente de Negócios, crie uma business.facebook.com antes de prosseguir.
• Um número de telefone válido — é esse o número pelo qual os clientes vão te mandar mensagem. Deve ser um número de telefone registrado pela empresa, não pessoal. O número já não pode estar registrado no aplicativo móvel WhatsApp ou WhatsApp Business — se estiver, você deve removê-lo desses aplicativos primeiro.
• Verificação do número de telefone — durante o processo de configuração, a Meta enviará um código de verificação para o número via SMS ou chamada de voz. Certifique-se de ter acesso para receber mensagens ou chamadas nesse número.
• Um espaço de trabalho LenoChat — você precisa de uma conta ativa LenoChat. A integração WhatsApp está disponível em todos os planos, incluindo o plano gratuito.

Guia de Conexão Passo a Passo

Todo o processo de conexão acontece dentro do seu painel LenoChat e em uma janela pop-up onde você se autentica com o Meta. Siga esses passos com atenção para conectar seu número WhatsApp empresa.

• Passo 1: Faça login no seu painel de LenoChat e clique em Configurações na barra lateral de navegação à esquerda.
• Passo 2: Selecione Integrações no menu de configurações. A página de Integrações exibe todos os canais disponíveis, incluindo WhatsApp, Instagram e Facebook Messenger.
• Passo 3: Localize a seção WhatsApp na página de Integrações. Se você ainda não conectou WhatsApp, verá um painel com o logo do WhatsApp, uma lista de pré-requisitos e um botão de Conectar WhatsApp.
• Passo 4: Clique no botão Conectar WhatsApp. Uma nova janela pop-up se abre e direciona você para a página de login Facebook da Meta.
• Passo 5: Faça login na sua conta Facebook que tem acesso de administrador ao seu Facebook Business Manager. Se você já estiver logado, o pop-up pula essa etapa automaticamente.
• Passo 6: Conceda as permissões solicitadas. LenoChat requer duas permissões: whatsapp_business_messaging (para enviar e receber mensagens em seu nome) e business_management (para acessar os detalhes da sua conta WhatsApp Empresa). Clique em Continuar para aprovar.
• Passo 7: Selecione sua WhatsApp Conta Empresarial. Se você já tem um, escolha entre a lista. Se não, a Meta irá te orientar na criação de uma nova conta WhatsApp Business durante esse fluxo.
• Passo 8: Escolha o número de telefone que deseja conectar. Você pode selecionar um número verificado existente da sua conta WhatsApp Empresa ou registrar um novo número. Se registrar um novo número, a Meta enviará um código de verificação via SMS ou chamada de voz — insira o código para verificar.
• Passo 9: Complete a configuração guiada inserindo os dados do seu negócio (nome do negócio, categoria, descrição) conforme solicitado pela Meta. Esses dados aparecem no seu perfil WhatsApp Business, que os clientes veem.
• Passo 10: Assim que a configuração é concluída, a janela pop-up fecha automaticamente e seu painel de LenoChat atualiza para mostrar o número de WhatsApp conectado. Você verá uma confirmação mostrando seu nome e número de telefone verificados na seção WhatsApp da página de Integrações.

Gerenciando Números de WhatsApp Conectados

Uma vez conectado, seus números de WhatsApp Negócios são exibidos em uma tabela na página de Integrações, na seção WhatsApp. Cada linha mostra o nome da empresa verificada e o número de telefone. Você pode gerenciar seus números conectados a partir deste painel a qualquer momento.

• Visualizando números conectados — a seção WhatsApp exibe uma grade com duas colunas: Nome (seu WhatsApp Nome da empresa verificado) e Número (o número de telefone exibido, por exemplo +1 234 567 8900). Cada linha representa um número de telefone conectado.
• Desconectar um número — cada linha tem um botão de Desconectar. Clique nele e confirme a ação no diálogo que aparece. Desconectar remove o número de LenoChat, mas não afeta sua conta WhatsApp empresarial do lado da Meta. Você pode reconectar o mesmo número a qualquer momento repetindo os passos de configuração.
• Reconectar ou adicionar números — para adicionar um novo número ou reconectar um número previamente desconectado, clique em Conectar WhatsApp novamente e siga o mesmo fluxo de configuração. LenoChat remove todas as conexões previamente armazenadas para seu espaço de trabalho e as substitui pelos números selecionados durante o novo fluxo de conexão.
• Múltiplos números — se sua empresa usa mais de um número WhatsApp empresa (por exemplo, números separados para vendas e suporte), você pode conectar todos durante um único fluxo OAuth. Todos os números selecionados durante a configuração aparecerão na tabela e receberão mensagens de forma independente.

Como WhatsApp Mensagens Aparecem na Sua Caixa de Entrada

Quando um cliente envia uma mensagem WhatsApp para o seu número conectado, ela chega à sua caixa de entrada LenoChat em segundos. A experiência de entrada das conversas WhatsApp é quase idêntica à das conversas ao vivo, com alguns detalhes específicos WhatsApp.

• Distintivo de canal — toda conversa WhatsApp exibe um crachá de WhatsApp verde (código de cor #25D366) ao lado do nome do visitante para que os agentes possam identificar instantaneamente o canal sem abrir a conversa.
• Identidade do visitante — o nome WhatsApp exibido e o número de telefone do cliente são mostrados como o nome do visitante. Se o perfil WhatsApp do cliente incluir um nome, esse nome é exibido; caso contrário, o número de telefone é usado.
• Tipos de mensagens — mensagens de texto aparecem como balões de chat padrão. As imagens enviadas pelo cliente são exibidas em linha como miniaturas que os agentes podem clicar para visualizar em tamanho real. Anexos de documentos (PDFs, planilhas, etc.) aparecem como links de arquivo para download.
• Resposta — os agentes digitam sua resposta no mesmo campo de entrada de mensagem usado para todos os canais e apertam Enviar. A resposta é entregue ao aplicativo de WhatsApp do cliente via WhatsApp Business API. Não há diferença no fluxo de resposta em comparação com o chat ao vivo.
• Leno AI tratamento — se Leno AI estiver ativado para seu espaço de trabalho, as mensagens de WhatsApp recebidas são tratadas primeiro pela IA, assim como as mensagens de chat ao vivo. A IA responde usando sua base de conhecimento treinada. Se o cliente solicitar um agente humano ou a IA não conseguir resolver a consulta, a conversa é escalada para a fila de agentes seguindo as regras de handoff configuradas por você.

WhatsApp Janelas de Conversa API Empresarial

A WhatsApp Business API impõe uma janela de atendimento ao cliente de 24 horas. Entender como essa janela funciona é essencial para gerenciar WhatsApp conversas de forma eficaz em LenoChat.

• A janela de 24 horas — quando um cliente envia uma mensagem, uma janela de serviço de 24 horas se abre. Durante esse período, sua empresa pode enviar respostas ilimitadas para esse cliente sem custo adicional por mensagem (dentro do seu plano gratuito mensal ou alocação de plano pago).
• Janela de expiração — se passarem 24 horas desde a última mensagem do cliente sem que sua empresa responda, a janela de atendimento é encerrada. Depois disso, você não pode enviar mensagens adicionais ao cliente a menos que use um modelo de mensagem pré-aprovado (as mensagens modelo geram custos separados do lado da Meta).
• Reengajamento do cliente — a janela se reinicia toda vez que o cliente envia uma nova mensagem. Então, se um cliente te enviar mensagem novamente após o término do prazo, uma nova janela de 24 horas se abre e você pode responder livremente novamente.
• Impacto na LenoChat — LenoChat envia respostas pelo WhatsApp API, então as mesmas regras de janela de 24 horas se aplicam. Se um agente tentar responder a uma conversa WhatsApp após o término da janela, a mensagem pode não ser entregue. Garanta que os agentes respondam às WhatsApp conversas prontamente para permanecer dentro do prazo.

Tipos de Mensagem Suportados

Configuração do Webhook e Detalhes Técnicos

A integração WhatsApp da LenoChat utiliza a infraestrutura de webhook da Meta para receber mensagens em tempo real. O webhook é configurado automaticamente quando você completa o fluxo de conexão OAuth — não é necessário um ajuste manual do webhook do seu lado. Veja o que acontece nos bastidores para referência técnica.

• Verificação por webhook — quando o webhook é registrado, a Meta envia uma solicitação de verificação para o servidor do LenoChat. LenoChat responde com o token de desafio correto para confirmar que o endpoint está ativo e pertence a LenoChat.
• Entrega de mensagens — toda vez que um cliente envia uma mensagem para o número do WhatsApp conectado, a Meta entrega um payload webhook para o servidor da LenoChat. A carga útil inclui o conteúdo da mensagem, informações do remetente (número de telefone e nome de exibição), o ID do número de telefone receptor e um identificador único da mensagem.
• Roteamento de mensagens — LenoChat corresponde ao ID do número de telefone receptor com o número conectado do seu workspace, cria ou continua uma conversa na sua caixa de entrada e publica a mensagem na thread de conversa. Se Leno AI estiver ativado, a IA processa a mensagem primeiro.
• Mensagens de saída — quando um agente ou Leno AI envia uma resposta, LenoChat chama o WhatsApp Business API (Graph API v22.0) para entregar a mensagem ao aplicativo WhatsApp do cliente. A chamada API utiliza o token de acesso de longa duração obtido durante a conexão OAuth.
• Gerenciamento de tokens — durante o fluxo OAuth, LenoChat troca o código de autorização de um token de curta duração e depois o atualiza para um token de longa duração (válido por aproximadamente 60 dias). LenoChat armazena esse token de forma segura e o usa para todas as chamadas API em seu nome.

Desconectando WhatsApp do LenoChat

Se você precisar desconectar seu número de WhatsApp de LenoChat — por exemplo, para conectá-lo a outra plataforma ou remover a integração completamente — siga estes passos.

• Passo 1: Vá para Configurações → Integrações no seu painel de LenoChat.
• Passo 2: Na seção WhatsApp, encontre o número de telefone que você deseja desconectar.
• Passo 3: Clique no botão Desconectar ao lado desse número.
• Passo 4: Um diálogo de confirmação aparece. Clique em Confirmar para prosseguir com a desconexão.
• Passo 5: O número é removido de LenoChat. Novas mensagens recebidas para esse número não serão mais entregues na sua caixa de entrada LenoChat. O histórico de conversas existente desse número permanece na sua caixa de entrada para referência, mas nenhuma nova mensagem será adicionada.

WhatsApp Melhores Práticas de Integração

Para aproveitar ao máximo sua integração WhatsApp com a LenoChat, siga estas práticas recomendadas que ajudam a manter a entrega das mensagens, a satisfação do cliente e a conformidade com as políticas da Meta.

• Responda dentro do prazo de 24 horas — sempre responda às mensagens WhatsApp dentro de 24 horas após a última mensagem do cliente. Se você perder essa janela, não poderá enviar mensagens adicionais a menos que use uma mensagem modelo. Leno AI pode ajudar respondendo instantaneamente a perguntas comuns.
• Treine Leno AI com sua base de conhecimento — se Leno AI está lidando com WhatsApp conversas, certifique-se de que sua base de conhecimento seja abrangente e atualizada. WhatsApp clientes frequentemente esperam respostas rápidas e precisas, e uma IA bem treinada reduz significativamente o tempo de resposta.
• Use um número comercial dedicado — evite usar um número de telefone pessoal para a integração. Um número registrado na empresa constrói confiança com os clientes e garante que o número permaneça disponível mesmo que os membros individuais da equipe mudem.
• Monitore sua avaliação de qualidade WhatsApp Negócio — Meta atribui uma avaliação de qualidade (Alta, Média ou Baixa) ao seu número de telefone com base no feedback dos clientes. Uma avaliação de baixa qualidade pode resultar em limites de mensagens ou restrições de conta. Verifique sua classificação de qualidade regularmente no Meta Business Manager.
• Configure o horário de funcionamento — configure seu LenoChat horário de funcionamento para enviar mensagens automáticas quando sua equipe estiver offline. Isso gerencia as expectativas dos clientes e evita que eles esperem indefinidamente por uma resposta.
• Complete seu perfil WhatsApp Empresa — preencha o nome da empresa, descrição, endereço, e-mail e site no Meta Business Manager. Um perfil completo parece mais profissional e confiável para os clientes que visualizam os dados do seu negócio em WhatsApp.

Segurança e Manuseio de Dados

LenoChat lida com WhatsApp dados com os mesmos padrões de segurança aplicados a todos os outros canais. Entender como seus dados fluem entre Meta, LenoChat e seus agentes é importante para garantir conformidade e tranquilidade.

• Tokens OAuth — LenoChat armazenam o token de acesso de longa duração obtido durante o fluxo Meta OAuth. Este token concede permissão para LenoChat enviar e receber mensagens em seu nome. O token é armazenado de forma segura nos servidores da LenoChat e nunca é exposto ao código do lado do cliente ou ao armazenamento do navegador.
• Conteúdo da mensagem — mensagens são transmitidas entre Meta e LenoChat por meio de conexões HTTPS criptografadas. O conteúdo das mensagens é armazenado no banco de dados da LenoChat como parte do tópico de conversa, sujeito às mesmas políticas de retenção de dados que todos os outros canais.
• Privacidade dos números de telefone — os números de telefone dos clientes ficam visíveis para os agentes na caixa de entrada para que possam identificar a conversa. Números de telefone não são compartilhados com terceiros nem usados para qualquer propósito além de entrega de mensagens e rastreamento de conversas.
• Revogando acesso — se você desconectar WhatsApp ou excluir seu LenoChat workspace, o token armazenado é invalidado. Você também pode revogar o acesso da LenoChat diretamente do Meta Business Manager na seção de Configurações → Integrações do Negócio.

WhatsApp vs Outros Canais em LenoChat