Conexão com WhatsApp Cloud API

Business diretamente do site do WiiChat. Após o registro, você pode começar a usar a API com a ajuda do WiiChat para aprimorar sua experiência de engajamento do cliente.

Pré-requisitos

Antes de começar a usar a API do WhatsApp Business, você precisará do seguinte:

• Uma conta do Facebook.

• Acesso de administrador à sua conta do Meta Business Manager . Se você não tiver uma conta do Meta Business Manager, você pode criar uma durante o processo de inscrição incorporado. Além disso, a conta do Meta Business não deve ser bloqueada ( aqui você pode ver se há alguma restrição na sua conta do META Business)

• Cartão de crédito (Mastercard / Visa → Não aceita American Express!)

• Um número de telefone que pode ser registrado como remetente . Este número não deve estar conectado a nenhuma conta do WhatsApp (privada ou WhatsApp Business API). Você precisará acessar este número para receber um SMS ou uma chamada de voz para verificação. Se você tiver uma conta existente, poderá encontrar instruções sobre como excluí-la aqui.

Instruções passo a passo

Etapa 1: faça login com o Facebook

Para iniciar o processo, faça login na plataforma WiiChat, navegue até o “painel” e clique em “WhatsApp Cloud” na barra lateral esquerda e clique no botão “Conectar WhatsApp Cloud”:

Na janela pop-up, faça login na sua conta do Facebook ou selecione a conta que você já faz login no seu navegador.

Etapa 2: Crie ou selecione uma conta do Meta Business Manager

Você pode selecionar uma conta Meta Business Manager existente na qual você tenha permissões de administrador ou criar uma nova conta Meta Business Manager . Para criar uma nova conta, você precisará preparar as seguintes informações:

• Nome comercial legal

• Número de telefone comercial

• Site de negócios

• Endereço de e-mail comercial

• País

• Endereço corporativo

• Cidade

• Estado / Província / Região

Observe que o novo meta business manager criado será “ não verificado ”, você será recomendado a verificar seu meta business manager o mais rápido possível. Você pode seguir as instruções aqui .

Etapa 3: Crie um perfil comercial no WhatsApp

1. Insira o nome da sua conta comercial do WhatsApp (WABA)

Seu público não verá essas informações no seu perfil do WhatsApp.

2. Insira o nome do seu perfil comercial do WhatsApp Nome de exibição

3. Escolha uma categoria de negócios na lista

4. Insira uma descrição para sua empresa

Você pode editar a descrição a qualquer momento, inclusive após a verificação do remetente.

Etapa 4: Verifique o número comercial do WhatsApp

1. Insira o número de telefone que você deseja usar como seu número comercial do WhatsApp. Observe que esse número de telefone não pode usar nenhum serviço do WhatsApp.

2. Escolha um dos seguintes métodos de verificação:

• SMS

• Chamada de voz

Depois que seu número for verificado,

você será redirecionado para a tela abaixo e, ao clicar no botão “concluir”, você será redirecionado de volta para a plataforma WiiChat.

Etapa 5: Conclua o registro do seu número

Após ser redirecionado para a plataforma WiiChat, você verá a tela abaixo e clique no botão “Sincronizar números”:

e você verá os números que você acabou de registrar dentro da plataforma WiiChat. Por padrão, o status é “Pausado”, você precisa mudar o status para “Ativo ”.

Por padrão, se você for em “Gerenciador do WhatsApp” e depois em “Números de telefone”, você notará que o status é “Pendente”, conforme a captura de tela abaixo:

Agora, se você voltar ao WiiChat, clicar em “configurações” conforme a captura de tela abaixo, clicar em “Registrar número” e registrar seu número :

E assim que você concluir o registro, você verá que o status do seu número de telefone agora é “Conectado” .

E agora seu bot está pronto para ser testado!

Mas antes de começar a testar, é muito importante configurar suas faturas e verificar seu meta business manager (não é obrigatório, mas é altamente recomendado)

Etapa 6: faça uma verificação rápida de conexão

Depois que o número do WhatsApp estiver conectado, você pode clicar em “Criar fluxo” e criar um fluxo simples no seu fluxo principal.

Clique no botão “Publicar” para publicar o fluxo e, em seguida, envie qualquer mensagem do seu número pessoal do WhatsApp para este número da API do WhatsApp Cloud.

Você deve receber a mensagem de texto de volta. Se você vir a mensagem, então a conexão está boa. Seu bot está responsivo e funcionando bem.

Agora, você pode ir em “Conteúdo”, “Modelos de mensagens” e clicar no botão “Sincronizar”. Se não vir nenhuma mensagem de erro, então a mensagem do modelo do WhatsApp também está funcionando.

Observe que não há nenhuma mensagem de modelo que realmente sincronizará de volta para o WiiChat quando você começar. Você também pode clicar em “+ Novo modelo” e criar uma nova mensagem de modelo do WhatsApp diretamente do WiiChat.

Por fim, você pode ir em “Gerenciador do WhatsApp” no seu meta gerenciador de negócios e conectar um cartão de crédito válido à cobrança, e então você pode testar para enviar uma mensagem de modelo do WhatsApp para um usuário do WhatsApp.

Se o seu método de cobrança for válido, a mensagem modelo deverá ser entregue sem problemas.

Se você fez todos os testes, sua API do WhatsApp Cloud está corretamente conectada.

Configurações do WhatsApp Cloud

O WiiChat oferece algumas configurações que podem ajudar você a gerenciar sua API do WhatsApp facilmente. Se você clicar nos 3 pontos na Nuvem do WhatsApp, encontrará as configurações abaixo:

• Exame de saúde

• Status de verificação comercial

• Verifique o método de pagamento

• Números de telefone

• Modelos de mensagens

• Catálogo

• Autenticação de dois fatores

• Número de cancelamento de registro

Processo de verificação empresarial do BM (opcional)

Se você não tiver concluído o processo de Verificação Comercial, você estará limitado a se associar a apenas dois números de telefone e poderá ter no máximo 250 conversas por dia.

Se esse limite for excedido, a conta será automaticamente cancelada após 15 dias.

No entanto, durante esse período, você ainda pode testar o serviço. Depois que seu negócio for verificado, você pode associar o WABA a até 20 números de telefone e o limite de conversas aumentará para 1000 por dia.

Verifique o método de pagamento

A primeira coisa que você faz é conectar um cartão de crédito válido aos seus números WABA. Se você não tiver conectado um cartão válido e começar a enviar uma mensagem de modelo do WhatsApp, verá o erro abaixo:

[ { "error_code": 141006, "error_description": "Há um erro com o método de pagamento.", "possible_solution": "Houve um erro com seu método de pagamento. Adicione um novo método de pagamento à conta." } ]

Basta conectar um cartão de crédito válido aos seus números waba.

Você precisará acessar o gerenciador de negócios e encontrar a conta do WhatsApp.

E clique em “Configurações de pagamento”

Você pode definir seu pagamento em https://business.facebook.com/billing_hub/payment_methods e ver o método de pagamento do WhatsApp.

Exame de saúde

Se você clicar na verificação de integridade, verá a captura de tela abaixo:

Isso lhe dará uma visão geral do status do seu número de telefone, status WABA e status da conta Meta Business.

Números de telefone

Uma conta comercial do WhatsApp (WABA) precisa de um número de telefone válido e dedicado ao uso da plataforma comercial do WhatsApp.

Este guia explica como escolher números de telefone, adicioná-los à sua conta e as limitações de envio relacionadas.

Depois de clicar nesta opção, você será redirecionado para “números de telefone” no seu gerenciador do WhatsApp, e o status do seu número de telefone se enquadrará nas categorias abaixo:

O status é classificado da seguinte forma:

• Conectado : O remetente funciona normalmente.

• Sinalizado : Este status ocorre quando a classificação de qualidade do remetente atinge um estado baixo (vermelho). Durante esse estado, você não pode atualizar o nível de limite de mensagens. Se a classificação de qualidade melhorar para um estado médio ou alto dentro de 7 dias a partir do dia em que o status do remetente foi movido para Sinalizado, o status muda para Conectado. Se a classificação de qualidade não melhorar, o status do remetente retorna para Conectado, mas o limite de mensagens diminui para o próximo nível mais baixo. O nível mais baixo para empresas verificadas é o Nível 1.

• Restrito : Este status ocorre quando o remetente atinge o limite de mensagens. Durante a fase Restrito, você não pode enviar nenhuma mensagem de saída (notificação) até que a janela de 24 horas seja redefinida. Você só pode responder a mensagens que os usuários finais iniciam.

• Pendente : Você pode clicar em “registrar números” para conectar seus números de telefone.

Adicionar um número de telefone a um WABA

Atualmente, cada Meta Business Manager verificado pode ter até 20 números de telefone, independentemente do número de WABAs.

Se você quiser adicionar um novo número, adicione-o por meio do processo de inscrição incorporado.

Alterar nome de exibição

Cada número de telefone tem seu nome de exibição, e esse nome deve estar relacionado ao nome da sua empresa ou marca. O nome de exibição será revisado pelo Meta. Você pode ir ao Meta para alterar o nome.

Excluir número de telefone de um WABA

Para remoção completa, siga os passos abaixo:

1. No Gerenciador de Negócios, acesse a página Configurações da sua empresa.

2. Acesse Configurações > Configurações comerciais > Contas do WhatsApp > Gerenciador do WhatsApp > Números de telefone.

3. No WhatsApp Manager, encontre o número de telefone que você deseja excluir. Clique no ícone de lixeira em Delete no canto superior direito.

Modelos de mensagens

Este link redirecionará você para a seção de modelos do WhatsApp no ​​gerenciador do WhatsApp, onde você poderá criar e enviar modelos diretamente no gerenciador do WhatsApp. Depois que o modelo for aprovado, você poderá acessar o WiiChat para sincronizá-lo de volta ao WiiChat.

Você também pode clicar no botão “Novo modelo” no WiiChat e então criar e enviar o modelo diretamente dentro do WiiChat.

Catálogo

As empresas podem habilitar catálogos para compartilhar produtos com clientes usando mensagens de vários produtos e produtos individuais ou exibir seus produtos e serviços aos clientes no aplicativo WhatsApp, permitindo que eles naveguem e adicionem itens ao carrinho sem sair da conversa, proporcionando uma experiência de compra perfeita e conveniente.

Se você clicar no link “Catálogo”, você será redirecionado para o Gerenciador do WhatsApp, clique em “Catálogo”, depois clique em “Escolha um catálogo” e, no menu suspenso, selecione o catálogo que deseja conectar.

Clique em “Exibir catálogo” se quiser visualizar ou gerenciar o catálogo. Clique em “Conectar catálogo” e então esses números WABA serão conectados ao catálogo.

Se você quiser sincronizar o catálogo de produtos do Facebook com o e-commerce nativo do WiiChat, você pode ir em “Integrações”, depois ir na categoria “E-commerce”, clicar em “Facebook Business” e fazer login na sua conta do Facebook.

Depois de fazer login na sua conta do Facebook, você será redirecionado de volta para o WiiChat e, em seguida, clique no botão “Listar catálogos de negócios”.

Encontre o catálogo vinculado aos seus números WABA e clique no botão “Facebook → Local”. Os produtos do seu catálogo serão sincronizados novamente com o WiiChat Ecommerce → Produtos.

Se você abrir qualquer produto sincronizado com WiiChat Ecommerce → produtos, todos os títulos, descrições, imagens e preços dos produtos serão sincronizados com as mensagens do Catálogo do Facebook.

Você precisará do retailID para enviar uma mensagem de catálogo de produtos do WhatsApp. Você pode encontrar o retailID sincronizado com o SKU na seção de produtos.

Confira mais informações sobre como criar uma experiência de compra nativa no WhatsApp para comércio eletrônico aqui .

Atualizar nome de exibição do WhatsApp

Sua empresa pode alterar os nomes de exibição até 4 vezes em um período de 30 dias. Após o período de 30 dias, um novo período de 30 dias começa e sua empresa pode alterar novamente os nomes de exibição até 4 vezes neste novo período de 30 dias.

Se você quiser atualizar seu nome de exibição do WhatsApp, você precisa ir para o meta business manager e ir para o WhatsApp manager

Clique no link azul e selecione o número de telefone cujo nome de exibição você deseja atualizar e, em seguida, clique no ícone “Editar” conforme a captura de tela abaixo

Na seção Editar Nome de Exibição , insira um novo nome de exibição. Os nomes de exibição devem ter um relacionamento com sua empresa e usar branding consistente com fontes externas (por exemplo, seu site).

Seu nome de exibição precisará ser aprovado pelo WhatsApp antes que um certificado atualizado fique disponível. Após a aprovação, registre novamente seu número e então seu nome de exibição estará ativo.

Como adicionar números de telefone extras no WiiChat

Primeiro, você precisará adicionar os novos números de telefone na sua conta do gerenciador do WhatsApp a partir do meta business manager.

Depois que o novo número de telefone for adicionado à sua conta de gerente do WhatsApp, você pode ir ao WiiChat e clicar em “Sincronizar números”

Então você verá o novo número adicionado ao WiiChat.

Nas configurações, você precisará primeiro “Verificar o número de telefone” e depois “Registrar o número”

Você pode clicar em “Verificar o número de telefone” primeiro.

Esta opção só está disponível para o novo cadastro de incorporação. O antigo método de conexão de aplicativo privado não tem essa opção.

Depois você pode escolher SMS ou Voz para verificar o número de telefone.

Depois que o número de telefone for verificado, você poderá prosseguir com as https://wiichat.atlassian.net/wiki/spaces/KB/pages/edit-v2/1933701#Etapa-3%3A-Crie-um-perfil-comercial-no-WhatsApp .

Quais são os possíveis erros comuns no fluxo de inscrição incorporado?

Verifique os erros comuns do meta oficial aqui .

A. Erros de criação de conta do Business Manager

Ocorreu um erro ao processar esta solicitação. Tente novamente mais tarde.

Este é o erro mais obscuro que precisa de mais assistência. A criação da conta comercial pode ter falhado devido a vários motivos.

==> Se você receber esse erro, use uma conta ativa do Facebook ou entre em contato com o Suporte para resolução.

Você atingiu o limite do número de negócios que pode criar neste momento.

Há um limite para o número de Contas Comerciais que você pode criar.

==> Use uma conta comercial existente ou exclua/feche contas comerciais não utilizadas

Sua conta do Facebook é muito nova para criar uma conta comercial. Tente novamente em uma hora.

Novas contas do Facebook precisam esperar algum tempo para criar uma conta no Gerenciador de Negócios.

=> Por favor, use uma conta ativa existente do Facebook ou aguarde algumas horas antes de usar sua nova conta. A nova conta do Facebook pode ser usada ativamente durante o período de espera.

Limitamos a frequência com que você pode postar, comentar ou fazer outras coisas em um determinado período de tempo para ajudar a proteger a comunidade de spam. Você pode tentar novamente mais tarde.

Sua conta do Facebook foi sinalizada devido a comportamento suspeito.

==> Você precisa usar uma conta do Facebook existente e ativa, sem problemas anteriores.

Você não tem mais permissão para usar os Produtos do Facebook para anunciar. Você não pode executar anúncios, gerenciar ativos de publicidade ou criar novas contas comerciais ou de anúncios.

Você não consegue criar novas contas no Business Manager devido a comportamento suspeito anterior.

==> Use uma conta do Facebook existente e ativa, sem problemas anteriores.

Sua conta de pagamento está desativada

Sua conta de pagamento foi desativada devido a comportamento suspeito anterior.

==> Entre em contato com o Facebook para obter ajuda aqui

Um usuário só pode criar um usuário comercial por vez

Você só pode criar uma única Conta Comercial dentro de um determinado período de tempo.

==> Use uma conta comercial existente para fazer a integração.

O nome que você escolheu para seu negócio não é válido. Considere usar xxx.

==> Adicione um nome válido que corresponda ao nome da sua empresa.

B. Erros na criação de conta comercial do WhatsApp

O usuário não tem permissão para criar contas comerciais do WhatsApp.

Você não tem a permissão de nível de administrador necessária para criar contas do WhatsApp na conta comercial selecionada.

==> Obtenha acesso de administrador à conta comercial para prosseguir ou selecione uma conta para a qual você tenha permissões de administrador.

Esta conta comercial do WhatsApp não está disponível para uso.

Se você vir essa mensagem de erro e não conseguir selecionar a conta comercial do WhatsApp que deseja. É por um dos motivos abaixo:

• Você não tem permissão para gerenciar essa conta comercial do WhatsApp

• Essa conta comercial do WhatsApp já é gerenciada por aplicativos privados ou outra plataforma

A solução para esse problema é solicitar permissão de administrador para a conta comercial do WhatsApp ou desconectar a conta comercial do WhatsApp de outras plataformas.

Você só pode criar um número limitado de Contas do WhatsApp Business antes que sua verificação de conta comercial e do WhatsApp seja concluída. Você pode criar contas adicionais depois de ser verificado.

Você tentou criar várias contas comerciais do WhatsApp em uma empresa não verificada.

==> Você pode criar Contas Comerciais WhatsApp adicionais somente quando a Verificação Comercial e as verificações de conta do WhatsApp estiverem concluídas. Inicie a Verificação Comercial para a conta visitando o Business Manager.

Não podemos verificar a Conta Comercial do Facebook que você selecionou. Volte para a tela anterior para selecionar uma conta diferente ou vá para o Gerenciador de Negócios do Facebook para obter suporte.

A conta comercial do Facebook selecionada não está em conformidade com nossas políticas de uso da API do WhatsApp Business e não pôde ser verificada.

==> Visite sua conta do Business Manager para obter mais informações sobre esta Conta Comercial do Facebook. Se o envio da sua Verificação Comercial for rejeitado, você deve ter recebido uma notificação por e-mail com os motivos detalhados. Você pode tentar reenviar sua Verificação Comercial se achar que isso foi um erro ou criar uma Conta Comercial do WhatsApp usando uma Conta Comercial do Facebook que já tenha sido verificada.

Algo deu errado. Você precisará entrar em contato com o suporte e tentar novamente.

Este pode ser um problema intermitente no WhatsApp.

==> Você pode tentar o fluxo novamente em alguns minutos.

Você já vinculou o número máximo de números de telefone permitidos para esta conta comercial. Exclua um número de telefone para continuar ou solicite números adicionais.

Por padrão, o Meta permite no máximo 2 números de telefone para uma conta comercial do WhatsApp. Se precisar de mais números, entre em contato com o suporte do Meta para aumentar os limites de números permitidos.

De acordo com as metapolíticas: “Os portfólios comerciais são inicialmente limitados a 2 números de telefone comerciais registrados, mas esse limite pode ser aumentado para até 20.

Se sua empresa tiver sido https://www.facebook.com/business/help/1095661473946872 ou se você abrir 1.000 ou mais https://developers.facebook.com/docs/whatsapp/messaging-limits em um período de 30 dias usando modelos com uma classificação de alta qualidade , determinaremos se o uso da sua API justifica um aumento no limite do número de telefone.”

Saiba mais sobre os limites de números de telefone aqui .

C. Erros de configuração do telefone

Este número de telefone já existe na sua lista de números de telefone.

Você está tentando adicionar um número de telefone que já existe na sua conta comercial do WhatsApp.

==> Volte para o fluxo ou reinicie-o para selecionar o número de telefone existente.

Este número está registrado em uma conta existente do WhatsApp. Para usar este número, desconecte-o da conta existente. Em seguida, retorne a esta página e insira novamente o número. Observação: pode levar até 3 minutos para que o número fique disponível.

O número de telefone já estava registrado em nossa plataforma (ou seja, WhatsApp Messenger, WhatsApp Business App ou Whatsapp Business API).

==> Vá para as configurações do “WhatsApp Cloud” e cancele o registro do número se quiser usá-lo ou registre um novo número.

Seu nome verificado viola as diretrizes do WhatsApp. Edite seu nome verificado e tente novamente.

O nome usado para o perfil comercial do número de telefone não atende às nossas diretrizes.

==> Consulte as diretrizes de nome de exibição e tente novamente.

Algo deu errado. Você precisará entrar em contato com o suporte e tentar novamente.

Ocorreu um problema ao criar o Perfil Comercial do número de telefone.

==> Digite novamente o nome correto do Perfil Comercial de acordo com as diretrizes e outros detalhes.

D. Erros de verificação de telefone

A propriedade do número de telefone já foi verificada.

==> Este número de telefone já foi verificado. Você pode tentar atualizar a página para ver a alteração aplicada.

Seu número de telefone não parece ser válido. Por favor, verifique novamente ou tente novamente após 5 minutos.

Um número de telefone incorreto foi inserido ou não oferecemos suporte a números neste formato.

==> Certifique-se de que o número esteja operacional e verificado por uma operadora de telecomunicações. Atualmente, não oferecemos suporte a números de Resposta de Voz Interativa (IVR).

Você já adivinhou muitas vezes.

Para bloquear spam, o sistema permite apenas um número limitado de tentativas de verificação.

==> Você tem que esperar por cerca de 12 horas antes de tentar novamente. Após esse período de espera, volte ao fluxo e selecione contas e números de telefone existentes para verificar novamente.

Houve um erro ao verificar este número de telefone. Tente novamente mais tarde.

Ocorreu um problema com o código de verificação.

==> Tente novamente mais tarde.

Você solicitou seu código muitas vezes.

Para bloquear spam, o sistema permite apenas um número limitado de tentativas de verificação.

==> Limitamos o número ou as vezes que você pode solicitar um código dentro de um determinado período de tempo. Volte ao fluxo após o tempo especificado e selecione contas e números de telefone existentes para solicitar um código novamente.