# 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**.
2. Clique no **botão "Criar modelo"** . Isso abre a página de criação de modelos. 3. 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.
4. 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. {% hint style="danger" %} Nosso sistema é adaptado para variáveis do MaviBot e **não oferece suporte** a variáveis no `{{1}}` formatar {% endhint %} #### 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](https://business.facebook.com/wa/manage/message-templates/). 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](https://developers.facebook.com/docs/whatsapp/business-management-api/message-): 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:**](/doc/pt/chatbot/builder/botoes.md) Um máximo de **3** pode ser usado em um bloco. 2. [**Botões inline**](/doc/pt/chatbot/builder/botoes.md)**:** 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. {% hint style="info" %} O pagamento é feito diretamente para **360dialog**. {% endhint %} ## 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). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/pt/chatbot/mensageiros/waba.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.