Neste guia passo a passo, descreveremos em detalhes como obter o API do WhatsApp Business por meio do parceiro oficial do Facebook - o serviço Gupshup e integrar com os Canais Abertos do Bitrix24 CRM.

Se você já tem uma conta do Facebook Business Manager, pule esta etapa e vá para a próxima.

Faça login em sua conta pessoal do Facebook e crie uma conta de Business Manager seguindo o link https://business.facebook.com/overview e clicando no botão "CRIAR CONTA", uma janela para inserir os dados da empresa será aberta.

De acordo com os prompts acima dos campos, digite o nome da empresa, nome e sobrenome, e-mail e pressione o botão "Avançar".

Na janela seguinte, insira as informações sobre a empresa e pressione o botão "Enviar".

Após o envio, aparecerá uma mensagem informando que a conta foi criada e você precisa confirmar seu endereço de e-mail.

Vamos ao correio e clicar no botão "Confirm Now" da carta.

Se você já tem esse botão ativo ou se sua empresa já foi verificada no Facebook Business Manager, pule esta etapa e prossiga para a próxima.

Por padrão, o botão para iniciar a verificação de negócios no Facebook Business Manager está desabilitado. Para torná-lo ativo, você precisa executar as etapas descritas a seguir.

Faça login em https://developers.facebook.com. Para fazer isso, clique no item "Introdução" no menu superior.

Na janela seguinte, clique no botão "Continuar".

Na janela seguinte, marque a caixa e clique no botão "Confirmar e-mail".

Na janela seguinte, selecione "Desenvolvedor" e clique no botão "Concluir registro".

Na próxima janela, clique no botão "Criar aplicativo".

Na janela seguinte, selecione "Gerenciar integrações de negócios" e clique no botão "Continuar".

Na janela seguinte, insira qualquer "Nome de exibição do aplicativo", selecione "Objetivo do aplicativo" - "Você ou sua empresa proprietária", selecione sua "Conta de gerente de negócios" e clique no botão "Criar aplicativo".

Depois de criar o aplicativo com sucesso, a página inicial do Facebook App Dashboard será aberta.

O botão "Iniciar verificação" agora está ativo.

Se sua empresa já foi verificada no Facebook Business Manager, pule esta etapa e vá para a próxima.

Vá para a seção Central de Segurança em https://business.facebook.com/settings/security. O botão "Iniciar verificação" agora está ativo. Clique nele para iniciar a confirmação.

As informações oficiais do Facebook sobre a verificação da empresa podem ser encontradas no link: https://www.facebook.com/business/help/2058515294227817?id=180505742745347.

Na primeira etapa da verificação, inseriremos os dados de nossa empresa:

Razão Social da empresa - o nome da empresa, conforme indicado nos documentos de registo da empresa.

País - o país onde a empresa está registrada.

Endereço - logradouro e nº da residência do endereço legal da empresa, conforme indicado nos documentos de registo da empresa.

Endereço (cont.) - insira, se disponível.

Cidade - a cidade do endereço legal da empresa, conforme indicada nos documentos de registro da empresa.

Estado/província /região - A região da sede da empresa conforme indicada nos documentos de constituição da empresa.

CEP/código postal - O código postal da sede da empresa, conforme indicado nos documentos de registo da empresa.

Telefone comercial - o número de telefone pertencente a esta pessoa jurídica (deve haver documentos comprovativos: contrato, faturas de pagamento do telefone, etc.).

Site - o endereço do site da empresa (o domínio do site deve corresponder ao domínio do endereço de e-mail da empresa).

Depois de inserir os dados da sua empresa e clicar no botão "Avançar", o Facebook tentará encontrar em fontes abertas todas as empresas cujos dados sejam semelhantes aos que você inseriu.

1. Se essas empresas forem encontradas, elas serão mostradas na lista.

Escolha a opção mais adequada ou, se nenhuma não couber, selecione "Nenhuma dessas opções" e clique no botão "Avançar".

Se a sua empresa está na lista e você a escolheu, na terceira etapa, confirme os dados da sua empresa e clique no botão "Avançar".

Na quarta etapa, escolha um método de verificação. Você pode verificar o seu número de telefone. Selecione seu idioma e solicite uma ligação ou mensagem de texto.

2. Se o Facebook não encontrou sua empresa em fontes abertas, ou você não viu sua empresa na lista sugerida pelo Facebook, e você escolhe "Nenhum destes corresponde".

Verifique o nome legal da sua empresa.

Para fazer isso, você precisa carregar um documento oficial padrão que corresponda ao nome comercial legal inserido.

Os documentos aceitos para nome legal incluem:

• Alvará de funcionamento
• Certificado de Constituição ou Incorporação
• Certificado de registro de imposto ou IVA

Selecione o idioma do documento, carregue os documentos e clique no botão "Avançar".

Verifique seu endereço comercial ou número de telefone. Faça upload de um documento mostrando o nome legal de sua empresa, juntamente com o endereço de correspondência ou número de telefone que você inseriu e clique no botão "Avançar".

Os documentos aceitos para endereço / telefone incluem:

• Contas de serviços públicos, como eletricidade ou telefone
• Extrato bancário com endereço
• Licença comercial com endereço ou telefone

Escolha um método de verificação. Você pode optar por verificar por telefone ou pelo nome de domínio do seu site. Você pode ser verificado mais rapidamente se usar um e-mail associado ao domínio do seu site.

Digite o código de verificação. Verifique sua caixa de entrada de e-mail e digite o código fornecido. Clique no botão "Enviar".

A página "Informações comerciais" https://business.facebook.com/settings/info mostrará o status de verificação comercial "Em revisão". Agora você precisa aguardar a aprovação do Facebook, isso pode levar de 2 a 7 dias úteis.

A página "Central de Segurança" https://business.facebook.com/settings/security mostrará a Verificação de negócios "Enviado".

Após a verificação bem-sucedida, o status será atualizado para "Verificado".

Para criar uma conta com Gupshup, você só precisa entrar neste serviço através de qualquer uma das suas contas existentes do Google, Facebook ou GitHub na página https://www.gupshup.io/developer/whatsapp-api.

Imediatamente após o login, o Painel do WhatsApp será aberto. Clicamos ali no botão "Crie seu primeiro app".

Em seguida, clique no botão "Access API".

Digite qualquer nome de aplicativo gratuito, por exemplo "TestApp555" e clique no botão "Enviar".

Uma longa página se abrirá, role-a para baixo com o mouse e clique no botão "Próximo" na parte inferior.

A seguir, o botão "Ir ao painel" aparecerá abaixo, clique nele para ir até lá.

No painel https://www.gupshup.io/whatsapp/dashboard, clique no botão "Colocar no ar" do aplicativo criado.

Na próxima tela, clique em "Estou pronto".

Na próxima tela, selecione seu país.

Em seguida, role para baixo no quadro e clique em "Próximo".

Na próxima tela preencha o formulário com os dados da sua empresa de acordo com as informações da sua empresa no Facebook Business Manager https://business.facebook.com/settings/info e clique em "Próximo".

Um email do Gupshup será enviado ao endereço de email inserido no formulário com um botão para confirmá-lo. Confirme este e-mail clicando no botão "Verificar agora" no corpo da carta.

Após a confirmação bem-sucedida, a janela "Email Verification Complete" abrirá

e uma carta chegará informando que o e-mail foi verificado com sucesso.

Volte para a janela com o formulário. Verifique todas as informações inseridas e clique em "Confirmar".

Na próxima tela, insira o ID de sua empresa verificada no Facebook Business Manager, que você copia na página https://business.facebook.com/settings/info, e clique em "Salvar".

Se sua empresa ainda não foi verificada, um erro aparecerá: "The Facebook Business Manager ID does not seem to be verified. Please try again with a verified ID."

Nesse caso, você precisará primeiro passar pela verificação de sua empresa no Facebook Business Manager e, em seguida, retornar a esta etapa. Este processo é detalhado nas etapas 1-3 deste manual.

Se tudo estiver em ordem e sua empresa for confirmada, então a próxima tela será aberta, onde inserimos nosso número de telefone que queremos usar para a API WhatsApp Business. Antes de fazer isso, certifique-se de estudar as regras do Facebook para escolher esse número de telefone no link
http://developers.facebook.com/docs/whatsapp/guides/phone-number.

Selecione o código do país e digite o número do telefone, pressione o botão "Salvar".

Em seguida, inserimos o nome de exibição da sua empresa no WhatsApp. Antes de fazer isso, certifique-se de estudar as regras do Facebook para escolher um nome de exibição de um link: https://developers.facebook.com/docs/whatsapp/guides/display-name.

Insira um nome de exibição e clique no botão "Salvar".

Em seguida, você precisará confirmar o link para o Gupshup em sua página do Facebook Business Manager, para isso, em uma nova aba do navegador, clique no link https://business.facebook.com/settings/requests ou no Facebook Business Manager no menu da esquerda, selecione o item "Pedidos". Na aba "Recebido" haverá um pedido recebido do Gupshup, clique no botão "Aprovar".

Volte para a janela do Gupshup e clique no botão Aprovar.

Uma janela será aberta com a informação de que sua solicitação foi enviada e está aguardando aprovação do WhatsApp. Supostamente, isso levará de 2 a 7 dias úteis. Freqüentemente, tudo acontece mais rápido e talvez você receba uma resposta ao seu e-mail em 24 horas. Clique no botão "Ir para o painel".

A página principal do Dashboard será aberta e na lista de aplicativos do botão azul veremos o status atual "Aguardando Aprovação".

Após a aprovação, você receberá um e-mail do Gupshup e o status no botão azul mudará para "Verificação completa".

Em seguida, você precisará confirmar seu número de telefone usando SMS ou chamada de voz. Para fazer isso, clique no botão "Concluir verificação".

Na janela que se abre, clique no botão "Solicitar código por SMS" se o número do telefone for móvel ou "Solicitar código por chamada de voz" se o número do telefone não for móvel.

Estamos aguardando uma atualização automática da tela e enviando um código de confirmação para o seu número.

Depois de enviar o código para o seu número, abrirá automaticamente a seguinte tela, onde inserimos o código recebido e pressionamos o botão "Enviar".

Após o envio bem-sucedido, a seguinte janela será aberta com uma mensagem de que as informações da sua conta foram aprovadas e a verificação foi bem-sucedida. Clique no botão "Ir para o painel".

A página principal do Dashboard será aberta e na lista de aplicativos veremos o status verde atual "LIVE". Agora você pode usar seu número de telefone na API WhatsApp Business.

Também podemos personalizar o perfil da sua empresa no WhatsApp, por exemplo, fazer upload de uma foto do perfil e inserir outras informações sobre a sua empresa. Para fazer isso, siga o link "Configurações de perfil" na lista de aplicativos para editar um perfil.

Uma janela para editar o perfil será aberta, insira todas as informações necessárias lá.

Após inserir os dados do perfil, clique no botão "Salvar alterações".

Para começar a receber e enviar mensagens através do seu número de telefone conectado ao WhatsApp Business API Gupshup, você precisa conectar sua conta Gupshup ao Bitrix24.

No Bitrix24, instale o aplicativo WhatsApp Business API Gupshup do marketplace, para fazer isso, siga o link https://www.bitrix24.com.br/apps/?app=aiappspro.whatsapp_business_api_gupshup e clique no botão verde "INSTALAR".

Se você ainda não se conectou ao mercado Bitrix24, uma janela pop-up com o botão "LOGIN" será aberta. Clique para fazer login com sua conta Bitrix24.

Se você ainda não tem o Bitrix24, clique no link "CRIE SEU BITRIX24 AGORA MESMO" na mesma janela pop-up e registre o Bitrix24 em seu endereço de e-mail ou usando uma de suas contas de rede social propostas.

Depois de entrar com sucesso no mercado Bitrix24, na mesma janela pop-up que apareceu após clicar no botão verde "INSTALAR", selecione seu portal Bitrix24 na lista.

Seu Bitrix24 abrirá em uma nova aba do seu navegador com a proposta de instalação do aplicativo WhatsApp Business API Gupshup. Pressione o botão azul "INSTALAR".

Leia o contrato de licença e a política de privacidade clicando nos links e marque as caixas se concordar com os termos. Clique no botão verde "INSTALAR".

Após a instalação bem-sucedida, um chat de suporte de aplicativo 24 horas por dia, 7 dias por semana, será criado automaticamente em seu Bitrix24, no qual você pode escrever a qualquer momento se tiver alguma dúvida sobre como trabalhar com o aplicativo.

Assim que o aplicativo estiver instalado, vamos proceder à ativação do conector para a API WhatsApp Business no Contact Center Bitrix24.

Feche o slide de instalação do aplicativo, vá para o Contact Center Bitrix24 e clique no conector "WhatsApp Business API Gupshup" instalado.

No controle deslizante de configurações do conector aberto, clique no botão "CONECTAR".

Se vários canais abertos foram criados em seu Bitrix24, abaixo você precisará selecionar o canal aberto necessário ao qual deseja conectar o WhatsApp e, após selecionar, clique no botão "CONECTAR".

O mesmo controle deslizante abrirá a interface de configurações do conector.

Em uma nova guia do navegador, vá para o Painel Gupshup usando o link https://www.gupshup.io/whatsapp/dashboard, clique no ícone do seu perfil e copie a chave API na janela pop-up.

Volte para a janela de configurações do conector no Bitrix24 e no campo "Gupshup API key" insira a API Key copiada em sua conta Gupshup.

Em uma nova guia do navegador, volte para o painel do Gupshup usando o link https://www.gupshup.io/whatsapp/dashboard e copie o número de telefone para o campo "Remetente do Gupshup" clicando no link "Configurações" no lista de aplicativos em sua conta Gupshup.

Isso abrirá a interface de configurações do aplicativo no Gupshup, role para baixo até a seção "Verificar acesso à API e definir URL de retorno" e copie o número de telefone do campo "Remetente". Se o seu próprio número de telefone ainda estiver pendente, este campo conterá um número de telefone de teste do Gupshup, que você pode usar para testar o aplicativo agora.

Não feche esta janela de configurações do aplicativo no Gupshup por enquanto, ela será útil abaixo. Volte para a janela de configurações do conector no Bitrix24 e digite o número de telefone do remetente copiado no campo "Remetente Gupshup".

Clique no botão "To plug". Após a conexão bem-sucedida, as mensagens "Connector connected successfully" e "Copy callback URL and enter it in Gupshup settings" irão aparecer. Copie o "Gupshup callback URL" clicando no botão "Copy".

Volte para a janela de configurações do aplicativo aberto no Gupshup, clique na guia "URL de retorno / Link para o seu bot", alterne o controle deslizante para "ON".

Marque as caixas abaixo em "Selecione quais eventos de status de mensagem você deseja receber por meio do url de retorno de chamada". No campo "Insira o URL de retorno de chamada", insira o "URL de retorno de chamada Gupshup" copiado nas configurações do conector no Bitrix24 e pressione o botão "Definir" para aplicar as configurações.

O Conector Gupshup da API do WhatsApp Business está pronto para ser usado!

Se você ainda está aguardando a aprovação do seu número de telefone e deseja testar o conector por meio de um número de telefone de teste do Gupshup por enquanto, role para cima a página de configurações do aplicativo no Gupshup até a seção "Mecanismos inteligentes para registro e envolvimento do usuário" e clique em o ícone "Clique no link". Um botão será aberto em uma nova guia para confirmar o consentimento para receber mensagens de teste. Marque a caixa de seleção "Concordo ..." e clique no botão "Enviar mensagem". O aplicativo WhatsApp será aberto para enviar a mensagem predefinida "PROXY ..." do seu número pessoal do WhatsApp. Envie esta mensagem inalterada para o número de teste Gupshup. A resposta será "Bem-vindo! Agora você está batendo papo com ...". Agora você pode enviar mensagens de teste que serão enviadas para o canal aberto Bitrix24.

Abaixo estão alguns exemplos de envio e recebimento de mensagens por meio de um número de telefone comercial.

Envie uma mensagem, por exemplo, do seu número pessoal do WhatsApp, para o número de telefone da API do WhatsApp Business aprovado pelo Gupshup.

Aceite a mensagem no Canal Aberto do seu Bitrix24 e escreva uma resposta.

Todos os tipos de mensagens são suportados: mensagens de texto, imagens, vídeos, mensagens de voz, arquivos, coordenadas de localização. As mensagens são processadas de acordo com as configurações do Canal Aberto.

Para poder escrever para o usuário após 24 horas a partir do momento da última mensagem dele, é necessário preparar templates especiais e obter a aprovação do WhatsApp. A mensagem não deve ser promocional por natureza - o WhatsApp só aprova modelos de serviços e transações. Os modelos devem estar de acordo com as seguintes diretrizes: Política de negócios do WhatsApp, Política de comércio do WhatsApp.

Os modelos precisam ser criados em sua conta Gupshup. Para fazer isso, vá para o Painel Gupshup em https://www.gupshup.io/whatsapp/dashboard, siga o link Configurações na lista de aplicativos Gupshup.

Role a página de configurações que se abre para a seção "Verificar acesso à API e definir URL de retorno" e, a seguir, clique no link "Exibir modelos".

A página Lista de modelos é aberta em uma nova guia do navegador. A lista que se abre conterá apenas modelos para envio por meio do número de teste Gupshup marcado como "Permitido para uso no servidor de teste". Você não poderá usá-los para o seu número; você precisará criar seus próprios modelos.

Para adicionar o seu próprio modelo, clique no botão "Adicionar mais".

Na interface que se abre, preencha todos os campos obrigatórios e clique no botão "Visualizar e enviar". Abaixo está um exemplo de preenchimento dos campos de nosso modelo aprovado.

Verifique todos os detalhes e clique no botão "Enviar".

Após o envio, esperamos 1 a 2 dias úteis para que o modelo seja aprovado pelo WhatsApp. Ao mesmo tempo, nenhuma carta chega, você precisa verificar a mudança de status dos modelos enviados em sua conta Gupshup. No filtro, selecione "Aprovado" e uma lista de todos os seus modelos aprovados será aberta.

Abaixo na captura de tela está um exemplo de envio de uma mensagem modelo do Bitrix24.

Durante a instalação no Bitrix24, o aplicativo "WhatsApp Business API Gupshup" cria automaticamente um novo provedor de SMS "[WhatsApp Business API Gupshup]", só que este não envia SMS, mas sim mensagens para o WhatsApp.

O envio é realizado de forma manual e automática de qualquer lugar do CRM: desde robôs, processos de negócios, mailings de SMS e Messenger da seção de marketing de CRM, Leads de cronograma, Negócios, Contatos e Empresas.

Damos exemplos de envio de tais mensagens abaixo nas imagens.

Configuramos completamente o popular e requisitado canal WhatsApp do zero por meio da API oficial do WhatsApp Business.

Em comparação com APIs não oficiais, as principais vantagens de uma conexão oficial são:

• alta estabilidade e segurança;
• independência de equipamentos físicos (não há necessidade de manter o celular conectado à Internet o tempo todo);
• independência da interface web de mensagens (não há necessidade de escanear o código QR e transferi-lo para aplicativos de terceiros);
• amplas oportunidades de integração com sistemas externos para automatizar o processamento de mensagens.

Além disso, conectar a API WhatsApp Business através do parceiro oficial do Facebook - o serviço Gupshup permite reduzir o custo deste canal várias vezes em comparação com outros provedores da API oficial WhatsApp Business. E mesmo muitas vezes acaba sendo mais lucrativo em comparação com os custos de esquemas de conexão não oficiais. Por exemplo, muitos desses serviços oferecem apenas pacotes de mensagens ou diálogos com uma taxa mensal. E mais uma grande vantagem, você pode conectar um número ilimitado de seus números de telefone para a API do WhatsApp Business via Gupshup, e isso não afeta o custo.