Configuração do WhatsApp
O Argonautas suporta mensagens bidirecionais do WhatsApp. Uma vez conectado, as mensagens do WhatsApp dos hóspedes aparecem na sua caixa de entrada unificada, juntamente com e-mails, SMS e mensagens das OTAs. Este guia cobre todo o processo de configuração, os requisitos de modelos de mensagem e a solução de problemas.
Visão Geral
A API do WhatsApp Business é a base para a comunicação profissional pelo WhatsApp. Diferente do aplicativo WhatsApp para consumidores, a API Business permite que sua equipe gerencie conversas a partir de uma caixa de entrada compartilhada, envie modelos de mensagem e automatize respostas -- tudo sem vincular o canal a um único telefone. O Argonautas conecta-se à sua conta do WhatsApp Business para gerenciar o provisionamento de números, o roteamento e a entrega de mensagens.
Requisitos
Antes de começar, certifique-se de ter o seguinte:
| Requisito | Detalhes |
|---|---|
| Número do WhatsApp Business | Um número de telefone registrado (ou que possa ser registrado) no WhatsApp Business. Pode ser um número novo ou um existente -- mas não pode estar atualmente em uso no aplicativo WhatsApp para consumidores. |
| Conta no provedor de mensagens | Uma conta ativa no nosso provedor de mensagens do WhatsApp, com acesso à API. Sua chave de API deve ter estas permissões: Channels Sending and Receiving, Contacts API Access, Numbers API Access, Template Management, Webhook Subscription Management, Channels Viewer, Conversations API Access. Entre em contato com o suporte se precisar de ajuda para obter credenciais. |
| Facebook Business Manager | Uma conta Meta Business verificada vinculada ao seu perfil do WhatsApp Business. A API do WhatsApp Business requer verificação da Meta. |
| Acesso de administrador ao Argonautas | Você precisa de privilégios de administrador para configurar canais de mensagens em Configurações. |
Conectando Seu Número
Passo 1: Configurar as Credenciais do Provedor
- Navegue até Configurações > Mensagens no Argonautas.
- Na seção WhatsApp, clique em Conectar WhatsApp.
- Digite sua Chave de API e ID do Espaço de Trabalho. Eles são encontrados no painel do seu provedor de mensagens em Configurações da API.
- Clique em Verificar Conexão para confirmar que as credenciais são válidas.
Passo 2: Selecionar Seu Número
Uma vez que as credenciais são verificadas, o Argonautas consulta seu espaço de trabalho de mensagens em busca de números do WhatsApp disponíveis:
- Uma lista de números registrados aparece no modal de conexão.
- Selecione o número que deseja conectar.
- Clique em Conectar.
O sistema cria automaticamente o conector de canal e as assinaturas de webhook necessárias. Você não precisa configurar webhooks manualmente.
[Captura de tela: O modal Conectar WhatsApp mostrando credenciais verificadas e uma lista de números disponíveis para conectar.]
Passo 3: Verificar a Conexão
Após a conexão, a seção do WhatsApp em Configurações > Mensagens mostra:
- Status: Conectado (indicador verde)
- Número: Seu número do WhatsApp Business conectado
- ID do Canal: O identificador do canal (útil para solicitações de suporte)
Para confirmar que tudo funciona de ponta a ponta, envie uma mensagem de teste (veja Testes abaixo).
Modelos de Mensagem
A API do WhatsApp Business requer modelos de mensagem pré-aprovados para iniciar conversas com os clientes. Você pode responder livremente dentro de uma janela de 24 horas após a última mensagem do cliente, mas iniciar uma nova conversa ou enviar mensagens após o fechamento da janela requer um modelo.
Regras dos Modelos
- Os modelos devem ser enviados para aprovação da Meta através do nosso provedor de mensagens.
- A aprovação normalmente leva 24 a 48 horas.
- Os modelos podem incluir variáveis dinâmicas (ex.: nome do hóspede, data de check-in, nome da propriedade) que são preenchidas no momento do envio.
- Os modelos devem seguir as políticas de conteúdo da Meta -- sem conteúdo promocional em modelos utilitários, sem informações enganosas.
Modelos Comuns para Gestão de Propriedades
| Nome do Modelo | Caso de Uso | Exemplo de Conteúdo |
|---|---|---|
| Confirmação de reserva | Enviado quando uma nova reserva é confirmada | "Olá , sua reserva na de a está confirmada." |
| Informações pré-chegada | Enviado 1-2 dias antes do check-in | "Bem-vindo! Aqui estão suas instruções de check-in para ..." |
| Acompanhamento pós-checkout | Enviado após a partida | "Obrigado por se hospedar na . Esperamos que tenha gostado da sua estadia." |
| Lembrete de pagamento | Enviado quando um saldo está vencido | "Olá , um pagamento de está vencido para sua próxima estadia." |
Os modelos são gerenciados em Configurações > Mensagens > Modelos. Crie o conteúdo do modelo no Argonautas, e ele será enviado para aprovação da Meta.
Testando a Conexão
Após a configuração, verifique se as mensagens fluem corretamente em ambas as direções:
- Teste de entrada: Envie uma mensagem do WhatsApp de um telefone pessoal para seu número Business conectado. A mensagem deve aparecer na Caixa de Entrada do Argonautas em segundos.
- Teste de saída: Na Caixa de Entrada, responda à mensagem de teste. A resposta deve chegar no telefone pessoal como uma mensagem do WhatsApp do seu número Business.
- Teste de modelo: Se você tiver modelos aprovados, use o recurso de composição para enviar uma mensagem modelo para um número de teste. Verifique se o modelo é renderizado corretamente com as variáveis preenchidas.
Se qualquer etapa falhar, consulte a seção de solução de problemas abaixo.
Solução de Problemas
Mensagens Não Chegam na Caixa de Entrada
Verifique a configuração do webhook. O Argonautas registra webhooks automaticamente durante a configuração. Se os webhooks foram excluídos acidentalmente, desconecte e reconecte o canal do WhatsApp em Configurações > Mensagens para registrá-los novamente.
Verifique as permissões da chave de API. A chave de API deve incluir as permissões "Channels Sending and Receiving" e "Webhook Subscription Management". Permissões ausentes impedirão a entrega de mensagens.
Verifique o painel do seu provedor. Confirme se o canal aparece como ativo. Se o provedor relatar falhas na entrega, o problema está a montante do Argonautas.
Mensagens de Saída Falhando
Janela de 24 horas expirada. Se passaram mais de 24 horas desde a última mensagem do cliente, você deve usar um modelo aprovado para reiniciar a conversa. Mensagens de formato livre serão rejeitadas pelo WhatsApp.
Modelo não aprovado. Verifique o status de aprovação do modelo em Configurações > Mensagens > Modelos. Modelos pendentes ou rejeitados não podem ser enviados.
Número não verificado. Se a verificação da sua conta Meta Business estiver incompleta, o WhatsApp pode restringir o envio de mensagens. Complete a verificação no Meta Business Manager.
Conexão Aparece como Desconectada
Chave de API expirada ou revogada. Gere uma nova chave de API no painel do seu provedor e atualize-a em Configurações > Mensagens.
Problema no espaço de trabalho. Verifique se o ID do espaço de trabalho está correto e se o espaço de trabalho está ativo. O provedor ocasionalmente requer reautenticação após alterações de faturamento ou plano.
Reconecte o canal. Se as credenciais estiverem corretas, mas a conexão permanecer inativa, desconecte o canal do WhatsApp e reconecte-o. Isso registra novamente todos os conectores e webhooks.
Mensagens Entregues, mas Sem Confirmação de Leitura
As confirmações de leitura (duas marcas de verificação azuis) dependem das configurações de privacidade do WhatsApp do destinatário. Se um hóspede desativou as confirmações de leitura no telefone, as mensagens aparecerão como entregues (duas marcas de verificação cinzas), mas nunca como lidas. Este é um comportamento normal do WhatsApp e não um problema do sistema.
Conceitos-Chave
- Janela de 24 horas -- Regra do WhatsApp que permite respostas de formato livre apenas dentro de 24 horas após a última mensagem do cliente. Após isso, apenas modelos aprovados podem ser enviados.
- Modelo de mensagem -- Um formato de mensagem pré-aprovado necessário para iniciar conversas ou enviar mensagens fora da janela de 24 horas.
- Webhook -- Um callback HTTP automatizado usado para enviar mensagens recebidas ao Argonautas em tempo real.
Perguntas Frequentes
Posso usar meu número atual do WhatsApp? Sim, mas o número deve ser migrado para a API do WhatsApp Business. Isso significa que ele não funcionará mais com os aplicativos WhatsApp para consumidores ou WhatsApp Business. A migração é tratada através do seu provedor de mensagens e do Meta Business Manager.
Quantos números do WhatsApp posso conectar? Você pode conectar um número do WhatsApp por empresa no Argonautas. Se você gerencia várias marcas ou empresas, cada uma pode ter seu próprio número.
Os hóspedes precisam salvar meu número para me enviar mensagens? Não. Os hóspedes podem enviar mensagens diretamente para seu número do WhatsApp Business. No entanto, ter seu número salvo facilita para os hóspedes encontrarem e enviarem mensagens para você.
O que acontece se o provedor de mensagens tiver uma interrupção? As mensagens do WhatsApp de entrada e saída serão atrasadas até que a interrupção seja resolvida. As mensagens são enfileiradas e entregues uma vez que a conectividade seja restaurada. Entre em contato com o suporte para atualizações de status em tempo real.
Posso enviar mensagens do WhatsApp para hóspedes que reservaram pelo Airbnb? Apenas se você tiver o número de telefone do hóspede e ele tiver iniciado uma conversa no WhatsApp com você (ou você tiver um modelo aprovado para contatá-lo). As políticas de privacidade das OTAs podem limitar a disponibilidade do número de telefone.
Relacionado
- Guia de Mensagens -- A caixa de entrada unificada e o gerenciamento de conversas.
- Configuração de SMS -- Conectando canais de SMS.
- Configurações: Mensagens -- Todas as opções de configuração de canais de mensagens.