API do WhatsApp Business

O construtor MaviBot também oferece suporte à API oficial do WhatsApp Business.

Como conectar o WhatsApp Business

Para conectar a API do WhatsApp Business (WABA) ao seu projeto, vá para a Mensageiros e selecione API do WhatsApp Business.

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, digite 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, só podem ser usados modelos de mensagem do WhatsApp (ou mensagens de modelo do WhatsApp), durante as quais a comunicação ocorre gratuitamente dentro da categoria selecionada.

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

As seguintes categorias de mensagens estão 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 a WABA estão sendo moderados.

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 narcóticos, 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ção enganosa ou falta de detalhes claros sobre sua empresa ou serviço, o modelo não será aprovado.

  4. Coleta de informações confidenciais: modelos criados para coletar dados sensíveis do usuário (por exemplo, números de passaporte, dados de cartão bancário, números de documentos de identidade, endereços residenciais) falharão na moderação.

  5. Conteúdo ofensivo: qualquer mensagem que contenha informações que possam ofender 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 no seu fluxo antes de usá-lo como 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 aprovado pela Meta (Facebook).

  • Após 24 horas: Depois que 24 horas tiverem se passado desde a abertura do chat, você só pode enviar outro modelo aprovado para reengajar o usuário.

  • Observação sobre moderação: Os modelos podem falhar na moderação se contiverem variáveis (em escrita cirílica ou latina).

Criando modelos no MaviBot

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

  1. Clique no botão "Criar modelo" . Isso abre a página de criação de modelos.

  2. Os modelos de mensagem estão vinculados a blocos no seu fluxo. Por padrão, o conteúdo do modelo é obtido 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 modelos

Há 3 tipos de modelos disponíveis para escolha.

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

Como passar variáveis nos modelos

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

Usando variáveis em mensagens de modelo do WhatsApp

Se você precisar usar variáveis em modelos de mensagem, siga esta regra: sempre escreva os nomes das variáveis usando apenas letras latinas, por exemplo, #{exemplo}. Após o envio, verifique se as variáveis foram processadas corretamente conferindo a mensagem por meio do link.

Se um modelo contiver uma variável, mas o bot não atribuir um valor a ela ou o valor estiver ausente, a mensagem não será enviada!

Como os botões funcionam nos modelos

Os modelos de mensagem aceitam botões. No MaviBot, os botões são definidos de forma semelhante à sintaxe da

API do Facebook. Você pode conhecê-la seguindo o link:

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

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

Parâmetro

Obrigatório

Descrição

type

Sim

Valores: PHONE_NUMBER, URL e QUICK_REPLY

text

Sim

Texto do botão

url

Nenhum

A URL que será aberta

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

criar links dinâmicos.

phone_number

Nenhum

O número de telefone para o qual

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

exemplo

Nenhum

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

entender qual mensagem pretende enviar. Certifique-se

de que sejam exemplos e não contenham nenhuma informação confidencial ou pessoal.

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

Recursos dos botões nos modelos

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

  1. Call-To-Action (CTA): Um botão para um link ou número de telefone (exibido com um ícone de link ou de telefone ao lado do texto).

  2. Resposta rápida: Botões de texto padrão com limite de 20 caracteres.

Limitações:

  • Um único modelo pode conter até 3 botões de Resposta rápida e até 2 botões de 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 de Resposta rápida envia seu texto como uma mensagem de resposta do usuário.

  • Um Call-to-Action botão pode abrir um link para um arquivo.

  • Clicar em um Call-to-Action botão para uma chamada telefônica abre o discador padrão. No WhatsApp Web, aparecerá uma notificação informando que não é possível fazer chamadas pela versão para 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 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á informado.

Modelos com alta probabilidade de aprovação normalmente:

  • Usam linguagem clara e profissional.

  • Atendem a um caso de uso específico e legítimo (por exemplo, lembretes de compromisso, atualizações de pedido).

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

Olá, não conseguimos falar com você. Seria conveniente continuar a conversa por aqui?

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

Olá, sou John Smith da MaviBot. Antes, você solicitou 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 days_from_last_message() função na sua condição de gatilho.

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

days_from_last_message() == 0

Como usar botões sem modelos

Há dois tipos de botões disponíveis fora dos modelos, configurados da mesma forma que em outros mensageiros:

  1. Botões de resposta: Um máximo de 3 pode ser usado em um bloco.

  2. Botões inline: Você pode criar até 10, e eles aparecem como mostrado no exemplo.

Limitações importantes para botões sem modelo:

  • Os botões podem conter apenas text. Links não são suportados.

  • Sua única função é mover o cliente de um bloco para outro dentro do seu fluxo.


Restrições para contas não verificadas

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

  • 50 mensagens de modelo por dia (incluídas na mensalidade).

  • Sem restrições para mensagens recebidas.

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

Sistemas de pagamento

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

O pagamento é feito diretamente para 360dialog.

Erros no envio de mensagens

Possíveis motivos para a 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 Política de Privacidade.

  4. A mensagem não foi entregue para manter uma experiência de usuário de alta qualidade (isso é um bloqueio de política geral).

Atualizado