O construtor MaviBot também suporta a API oficial do WhatsApp Business.

Como conectar o WhatsApp Business

Para conectar a API do WhatsApp Business (WABA) ao seu projeto, vá para a seção Canais e selecione WhatsApp Business API.

Conectando a API do WhatsApp Business

Na janela que se abre, faça login com sua conta do Facebook. Em seguida, clique no botão "Conectar via Facebook".

Se necessário, insira sua senha do Facebook para continuar.

A configuração agora está concluída. Você não precisa manter seu telefone online o tempo todo; o bot operará de forma estável e autônoma.

Modelos de mensagem para a API do WhatsApp Business

Ao usar a API do WhatsApp Business, os usuários não podem escrever para os clientes a qualquer hora do dia e enviar mensagens ilimitadas ao criar um bot, semelhante ao WhatsApp cinza, fora da janela de atendimento ao cliente de 24 horas.

Fora da janela de 24 horas, apenas modelos de mensagem do WhatsApp (ou mensagens de modelo do WhatsApp) podem ser usados, durante os quais a comunicação ocorre gratuitamente dentro da categoria selecionada.

Essa funcionalidade é usada no WhatsApp para prevenir spam em envios em massa, limitando o número de mensagens permitidas em um determinado intervalo de tempo, bem como atribuindo uma categoria aos modelos.

Existem as seguintes categorias de mensagem instaladas para a API do WhatsApp Business pela Meta:

  1. Modelos úteis (contêm informações específicas sobre transações, faturas, pagamentos, etc.);

  2. Modelos para marketing (informações sobre a empresa, organização, estratégias, publicidade e promoção);

  3. Modelos para verificação e autenticação.

Os modelos criados para WABA passam por moderação.

Os principais motivos para rejeição de modelos

Um número significativo de modelos falha na moderação do WhatsApp por vários motivos:

  1. Publicidade excessiva: O WhatsApp Business rejeita modelos sobrecarregados com anúncios e conteúdo promocional. Se os moderadores ou a IA da plataforma determinarem que a publicidade ofusca a mensagem principal, o modelo será bloqueado.
  2. Violação da Política de Produtos: Modelos que promovem itens proibidos, como entorpecentes, substâncias psicotrópicas, álcool, tabaco, serviços íntimos ou qualquer conteúdo considerado degradante à dignidade humana serão rejeitados.
  3. Ambiguidade, omissão ou falsidade: Se os moderadores do WhatsApp detectarem qualquer subtexto oculto, informações enganosas ou falta de detalhes claros sobre sua empresa ou serviço, o modelo não será aprovado.
  4. Coleta de informações confidenciais: Modelos projetados para coletar dados sensíveis do usuário (por exemplo, números de passaporte, detalhes de cartão bancário, números de identificação pessoal, endereços residenciais) falharão na moderação.
  5. Conteúdo ofensivo: Qualquer mensagem contendo informações que possam ofender os usuários com base em raça, nacionalidade, gênero, identidade ou outros critérios será rejeitada.
  6. Rejeição discricionária: Os moderadores do WhatsApp reservam-se o direito de rejeitar modelos sem fornecer um motivo específico.

Como instalar modelos de mensagem

Como os modelos são criados a partir de blocos, você deve primeiro criar um bloco em seu fluxo antes de usá-lo para um modelo da API do WhatsApp Business.

  • Custo e primeira mensagem: O envio de mensagens de modelo é gratuito dentro da janela de conversa de 24 horas. A primeira mensagem para um cliente só pode ser um modelo que foi aprovado pela Meta (Facebook).
  • Após 24 horas: Depois que 24 horas se passaram desde a abertura do chat, você só pode enviar outro modelo aprovado para reengajar o usuário.
  • Nota de moderação: Os modelos podem falhar na moderação se contiverem variáveis (em scripts cirílicos ou latinos).

Criando modelos no MaviBot

  1. Vá para a seção Canais, selecione WhatsApp Business API e depois escolha Modelos de mensagem.

  1. Clique no botão "Criar modelo". Isso abre a página de criação de modelo.
  2. Os modelos são vinculados a blocos em seu fluxo. Por padrão, o conteúdo do modelo é extraído do bloco, mas você pode especificar texto e botões personalizados.

  1. O modelo de mensagem será enviado para moderação após a criação. Você só pode usar modelos aprovados. A moderação normalmente leva cerca de 8 horas, com um máximo de 48 horas.

Tipos de modelo

Existem 3 tipos de modelos disponíveis para escolher.

Você pode anexar uma imagem ao modelo MARKETING nos seguintes formatos: SVG, PNG, JPG e GIF.

Como passar variáveis em modelos

As variáveis em modelos são tratadas da mesma forma que em todo o MaviBot, não de acordo com o formato nativo do WhatsApp.

Nosso sistema é adaptado para variáveis MaviBot e não suporta variáveis no formato {{1}}

Usando variáveis em mensagens de modelo do WhatsApp

Se você precisar usar variáveis em modelos de mensagem, siga esta regra: sempre escreva nomes de variáveis usando apenas letras latinas, por exemplo, #{example}. Após o envio, verifique se as variáveis são processadas corretamente, verificando a mensagem através do link fornecido.

Se um modelo contém uma variável, mas o bot não atribui um valor a ela ou o valor está ausente, a mensagem não será enviada!

Como os botões funcionam em modelos

Os modelos de mensagem suportam botões. No MaviBot, os botões são definidos de forma semelhante à sintaxe da API do Facebook. Você pode se familiarizar com ela através do link:

Os botões são definidos no formato de array JSON.

Parâmetros de criação de botão:

Parâmetro Obrigatório Descrição
type Sim Valores: PHONE_NUMBER, URL e QUICK_REPLY
text Sim Texto do botão
url Não

A URL que será aberta

quando o botão for clicado. Você pode usar variáveis para

criar links dinâmicos.
phone_number Não

O número de telefone para o qual

a chamada será feita quando o botão for pressionado
example Não

Fornece um exemplo de dados possíveis para seu modelo. Isso ajuda no processo de revisão e aprovação para que você possa

entender qual mensagem planeja enviar. Certifique-se

de que são exemplos e não contêm informações confidenciais ou pessoais.

Por exemplo: Mensagem com dois botões: [{"type":"QUICK_REPLY", "text": "Sim, conveniente"}, {"type":"QUICK_REPLY", "text": "Inconveniente"}]

Recursos dos botões em modelos

Existem dois tipos de botões disponíveis em mensagens de modelo:

  1. Call-To-Action (CTA): Um botão para link ou número de telefone (exibido com um ícone de link ou telefone ao lado do texto).
  2. Quick Reply: Botões de texto padrão com um limite de 20 caracteres.

Limitações:

  • Um único modelo pode conter até 3 botões Quick Reply e até 2 botões Call-to-Action. No entanto, você não pode usar dois links ou dois números de telefone simultaneamente.
  • Os botões não podem incluir variáveis, quebras de linha, emojis ou símbolos de formatação.

Comportamento:

  • Clicar em um botão Quick Reply envia seu texto como uma mensagem de resposta do usuário.
  • Um botão Call-to-Action pode abrir um link para um arquivo.
  • Clicar em um botão Call-to-Action para uma chamada telefônica abre o discador padrão. No WhatsApp Web, uma notificação aparecerá informando que chamadas não podem ser feitas na versão desktop.

Como funciona a moderação de modelos

Cada modelo é enviado para moderação imediatamente após a criação. O processo normalmente leva cerca de 8 horas, com um tempo máximo de revisão de 48 horas.

Você pode acompanhar o status da moderação na sua lista de modelos.

Se um modelo for rejeitado, o motivo da rejeição será fornecido.

Modelos com alta probabilidade de aprovação normalmente:

  • Usam linguagem clara e profissional.
  • Servem a um caso de uso específico e legítimo (por exemplo, lembretes de consultas, atualizações de pedidos).

Importante: O texto em itálico pode ser variável e personalizado.

Olá, não conseguimos falar com você. Seria conveniente continuarmos a comunicação aqui?

Olá, você deixou uma mensagem no site e pediu para entrarmos em contato. (sujeito a alterações)

Olá, sou John Smith da MaviBot. Anteriormente, você se candidatou para a criação de um chatbot. Temos o prazer de informar que temos algumas novidades para você.

Modelos que não passarão na moderação:

qualquer texto publicitário

Como verificar se você está dentro da janela de 24 horas

Você pode determinar quantos dias se passaram desde a última mensagem do cliente usando a função days_from_last_message() na sua condição de gatilho.

Exemplo de verificação da janela de 24 horas:

days_from_last_message() == 0

Restrições para contas não verificadas

Contas comerciais não verificadas do Facebook enfrentam os seguintes limites:

  • 50 mensagens de modelo por dia (incluídas na taxa mensal).
  • Sem restrições em mensagens recebidas.

Para remover essas restrições, sua empresa deve concluir o processo de Verificação Comercial, que normalmente leva 2–3 semanas.

Sistemas de pagamento

Consulte seu revendedor para obter os preços de mensagens recebidas e enviadas para contas não verificadas.

O pagamento é feito diretamente para 360dialog.

Erros de envio de mensagens

Possíveis razões para falha na entrega:

  1. O número de telefone do destinatário não está registrado no WhatsApp.
  2. Tentativa de enviar um modelo da categoria "Autenticação" para um usuário do WhatsApp com o código do país +91 (Índia). Atualmente, modelos da categoria Autenticação não podem ser entregues a usuários na Índia.
  3. O destinatário não aceitou os Termos de Serviço e a Política de Privacidade atualizados.
  4. A mensagem não foi entregue para manter uma experiência de alta qualidade para o usuário (isso é um bloqueio de política geral).

Conversões de anúncios Click-to-WhatsApp

Uma adição à documentação para a função fb_pixel_event().

A Meta* marca cada clique de um anúncio Click-to-WhatsApp com um identificador de clique ctwa_clid. Ele é recebido junto com a primeira mensagem do cliente no WhatsApp e é usado para atribuir uma conversão da conversa a um anúncio específico — semelhante a como eventos de pixel são atribuídos a um clique no site.

Assinatura

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

Novos Parâmetros

Parâmetro Descrição
ctwa_clid Identificador de clique para um anúncio Click-to-WhatsApp. Se este parâmetro não for fornecido, a variável de cliente ctwa_clid, que é salva automaticamente pelo bot, é usada. Opcional.
messaging_channel O canal de mensagens onde a conversão ocorreu. O padrão é whatsapp. Opcional.

Novo Valor para action_source

A seguinte linha é adicionada à tabela de valores de action_source:

Valor Descrição
business_messaging A conversão ocorreu em uma conversa após o cliente clicar em um anúncio Click-to-WhatsApp.

Um evento é enviado como uma conversão de mensagens se pelo menos uma das seguintes condições for atendida:

  • action_source="business_messaging" é fornecido;
  • ctwa_clid é fornecido;
  • messaging_channel é fornecido.

Neste caso, a Meta* recebe a combinação action_source + messaging_channel + ctwa_clid. Sem essa combinação, o clique no anúncio não será atribuído à conversão.

O valor website não deve ser usado para conversões de mensagens: o evento chegará ao pixel, mas não será atribuído ao anúncio.

Variáveis de Cliente

Quando um cliente envia uma mensagem no WhatsApp após clicar em um anúncio, o bot salva os dados do clique nas variáveis de cliente do cliente. Você não precisa preencher essas variáveis manualmente.

Variável Descrição
ctwa_clid Identificador de clique. Adicionado automaticamente ao evento.
ctwa_clid_time Hora em que o identificador foi recebido, no formato de tempo Unix. Pode ser usado para determinar quanto tempo se passou desde o clique.
wa_ads_data Dados do anúncio em formato JSON: URL do anúncio, ID do anúncio (source_id), título, descrição, tipo de criativo e URL do criativo.

O identificador de clique é automaticamente obtido da variável de cliente, então você não precisa passá-lo explicitamente para a função.

O número de telefone do cliente é adicionado automaticamente ao evento se não for fornecido em data.

O parâmetro event_source_url não é usado para conversões de mensagens.

Limitações

O identificador de clique é recebido apenas com a primeira mensagem do cliente após ele clicar no botão do anúncio. Ele não é incluído em mensagens subsequentes. Portanto, o evento pode ser enviado em qualquer ponto durante a conversa, mas apenas se a primeira mensagem tiver origem no anúncio.

A Meta* fornece ctwa_clid para cliques nos aplicativos Facebook* e Instagram* no Android e iOS.

O identificador não é fornecido quando o cliente clica a partir de um navegador ou clica em uma postagem regular em vez do botão do anúncio. Conversões de tais interações não podem ser atribuídas ao anúncio.

Se o cliente clicar em outro anúncio mais tarde, as variáveis são sobrescritas. A conversão é atribuída ao anúncio mais recente do qual o cliente veio.

Se o identificador de clique estiver ausente tanto nos parâmetros da função quanto nas variáveis de cliente, a função retorna o erro No ctwa_clid variable in client variables e o evento não é enviado.