Ativando WhatsApp API Oficial

IMPORTANTE: Ainda não oferecemos serviço de atendimento (chat online), por isso, esteja ciente de que, no momento, ainda não será possível realizar atendimento aos seus clientes ou responder mensagens por meio da API oficial.

• Criar templates de rastreio
• Criar templates de situações (apenas para quem usa a Loja Integrada)
• Configurar variáveis para a API oficial no RastreioZap

Veja como configurar o número de WhatsApp na API Oficial. Para isso, usaremos o BSP Gupshup.

BSP (Business Solution Provider) de WhatsApp API é uma empresa parceira oficial da Meta (Facebook), autorizada a fornecer acesso, infraestrutura e suporte para a WhatsApp Business API. Entenda porque escolhemos usar um BSP no RastreioZap.

Esse guia será dividido em três etapas principais, são elas:

1. Configurando o Meta Business Manager
2. Criando e publicando aplicativo na Gupshup
3. Finalmente configurando o app no RastreioZap

É muito importante que você siga todas elas atentamente, sem pular nenhuma, pois o processo de configuração da Meta pode ser complexo.

Configurando o Meta Business Manager

1 - Faça login na sua conta da Meta Business: https://business.facebook.com e escolha ou crie um portfólio empresarial para sua loja.

Atenção: Não vincule nenhuma forma de pagamento ou escolha a moeda utilizada em seu portfólio criado. A forma de pagamento será vinculada à Gupshup depois de configurar as próximas etapas deste guia.

​2 - Se o portfólio ainda não for verificado, faça o processo de verificação com a Meta. A verificação do portfólio empresarial é essencial para aumentar a segurança e credibilidade do seu negócio dentro das plataformas da Meta.

Selecione a opção 'Centro de Segurança', localize a opção 'Verificação da Empresa' e clique em 'Iniciar Verificação'.

3 - Uma nova aba será aberta. Clique em 'Começar'.

4 - Enviando as informações da empresa:

• Informe em qual país a empresa está localizada;
• Informe o tipo da empresa (individual, corporação, etc);
• Informe se sua empresa tem registro oficial;
• Informe o nome legal da empresa conforme registrado;
• Forneça um CNPJ válido (MEI é aceito);
• Envie um comprovante de endereço ou outro documento oficial;
• Caso solicitado, envie documentação adicional para confirmação.

5 - Após preencher todos os dados solicitados, clique em 'Avançar'.

6 - Conclusão e Acompanhamento da Verificação.

Após enviar os documentos, acompanhe o status da verificação dentro da 'Central de Segurança'. O processo pode levar alguns dias e, caso haja pendências, a Meta enviará uma notificação com instruções.

1 - Depois que seu portfólio estiver criado e verificado na Meta Business Manager, acesse ou crie uma conta na Gupshup: https://apps.gupshup.io/whatsapp/dashboard

Após acessar o painel, altere a linguagem dele para português, para que possa seguir este guia de ajuda com mais facilidade.

2 - No dashboard, clique no botão 'Criar app', informe o nome e clique em 'Enviar'.

3 - Agora o app estará aguardando a configuração. Para isso, clique em 'Publicar' ou 'Iniciar transação'.

4 - Na tela que irá abrir, selecione 'Novo número de telefone' se quiser criar uma conta do WhatsApp Business desde o início, ou 'Migrar um número de telefone ativo' se deseja migrar de outro BSP para o Gupshup.

ATENÇÃO: O número de WhatsApp não poderá estar configurado no celular ou ter uma conta de WhatsApp ativa. Caso não possa perder acesso à conta no celular, utilize um número novo exclusivo para o RastreioZap. Ou, se deseja utilizar um número ativo, terá que exluir a conta do WhastApp através do celular primeiro.

5 - Preencha seus dados de contato, use um e-mail que esteja no mesmo domínio utilizado na loja e já tenha sido aprovado na Meta. O número de contato não será o número utilizado na API; informe um número que tenha acesso fácil.

6 - Na etapa 'Cadastro incorporado', clique em 'Continuar com o Facebook' para fazer login em sua conta.

6.1 - Na tela que irá se abrir, clique em 'Continuar' e selecione o portfólio empresarial criado anteriormente. Ele deve aparecer como 'Verificado' se você seguiu corretamente todas as etapas anteriores no Meta Business Manager.

6.2 - Selecione a opção 'Criar uma conta do WhatsApp Business' ou uma que você já tenha criado antes e esteja aparecendo.

ATENÇÃO: Nessa etapa a Meta costuma travar o processo de cadastro. Caso isso ocorra, entre em contato com o time de suporte da Gupshup por meio do e-mail: [email protected] e informe o problema para que eles possam auxiliar.

7 - Nas etapas seguintes, informe os dados da empresa e o número de WhatsApp que irá utilizar. Será necessário fazer a verificação do número a partir do recebimento de código por SMS ou ligação.

• Em 'Nome de Exibição do perfil do WhatsApp Business', será o nome que ficará disponível para seus clientes, então deve ser o nome da empresa/loja.
• Fuso horário mantenha 'América/São Paulo'.
• Em 'Categoria', coloque de acordo com o ramo da empresa ou 'Outro'.
• Descrição da empresa e site da empresa são opcionais.

Importante: Se o código de verificação do número não chegar na primeira tentativa, não clique em 'Reenviar'. Feche a janela do Facebook e siga os passos do item 6 novamente.

8 - Ao finalizar o cadastro incorporado, selecione no painel da Gupshup o 'telefone WABA' que acabou de cadastrar e confirme. Aguarde na tela até que o carregamento termine e apareça a confirmação, não feche antes disso!

9 - Agora seu aplicativo na Gupshup estará ativo, e você poderá configurar os templates e o RastreioZap.

1 - No painel do RastreioZap, acesse o menu 'Admin > Integrações > Gupshup BSP' e clique em 'Configurar'.

2 - Clique em 'Adicionar app' no canto superior direito da tela e preencha com os dados encontrados nas configurações do app no painel da Gupshup.

• ID do App - Identificação única do aplicativo. Encontre no menu 'Configurações'.
• Nome do App - Nome exatamente igual ao escolhido no cadastro do app, não é o nome da empresa/loja.
• Chave de API - Token que deve ser gerado no menu 'Configurações' no painel da Gupshup. Mantenha essa chave segura.
• Número de WhatsApp - Número configurado na API do WhatsApp para envio das mensagens. Insira o número completo com DDD.

3 - Após preencher os dados e salvar no painel do RastreioZap, você irá ver o app criado e com status Ativo. Agora você deve copiar a URL do webhook que irá aparecer e inserir na Gupshup.

3.1 - Na Gupshup, acesse o app que irá utilizar, clique na aba 'Webhooks' e em 'Adicionar webhook'.

• Nome do webhook - Coloque um nome de identificação que desejar, pode ser 'RastreioZap'.
• URL de retorno de chamada - Cole a URL obtida no painel do RastreioZap após configurar o app na etapa anterior.​
• Formato de carga útil - O RastreioZap está preparado para receber os dois formatos, mas dê preferência para o formato da Meta (v3). Selecione todos os 'Eventos de Mensagens' e 'Eventos do sistema'.