Introdução
Este guia ajudará você a enviar e receber sua primeira mensagem usando a API de Nuvem. Você também aprenderá a configurar webhooks para usar com um app de exemplo.
Este documento destina-se a pessoas que desenvolvem aplicativos para si mesmas ou para organizações próprias. Se você estiver criando um app que será usado por outras empresas, consulte Solution Providers.
Antes de começar
Você precisará do seguinte:
- Um conta de desenvolvedor da Meta: saiba mais sobre o processo de registro como desenvolvedor da Meta.
- Um app do tipo Empresa: saiba mais sobre a criação de apps. Caso você não veja a opção para criar um app do tipo Empresa, selecione Outro > Avançar > Empresa durante a criação do app.
Etapa 1: adicionar o produto WhatsApp ao app
Neste ponto, se você tiver criado um novo app, a solicitação Adicionar produtos ao seu app será exibida. Role a tela para baixo e, em WhatsApp, selecione Configurar. Você também pode selecionar seu app na tela Meus apps e seguir as mesmas instruções novamente para adicionar o WhatsApp.
Caso você tenha uma conta empresarial da Meta (MBA, pelas iniciais em inglês), será preciso anexá-la ao adicionar o produto WhatsApp ao seu app. Se não tiver uma, você receberá algumas instruções para criar a conta. Depois que sua MBA for anexada ao app, estará tudo pronto para iniciar os testes.
Veja o que acontece quando o produto WhatsApp é adicionado ao seu app:
- Você precisará criar uma conta empresarial da Meta, caso ainda não tenha uma.
- Uma conta de teste do WhatsApp Business será criada automaticamente para você. Essa conta tem limitações e deve ser usada para fins de teste e desenvolvimento, já que você não paga por mensagens.
- Será criado um número de telefone comercial de teste associado à sua conta do WhatsApp Business. Com esse número, você poderá enviar mensagens gratuitas para até 5 números de telefone de destinatários.
- Será criado um conjunto de modelos de mensagem pré-aprovados.
Etapa 2: adicionar um número de destinatário
Adicione um número válido do WhatsApp para enviar mensagens de teste.
No menu à esquerda do Painel de Apps, navegue até WhatsApp > Configuração da API. Em Enviar e receber mensagens, selecione o campo Para e escolha Gerenciar lista de números de telefone.
É possível adicionar qualquer número válido do WhatsApp como destinatário. O destinatário receberá um código de confirmação no WhatsApp que pode ser usado para verificar o número de telefone.
Após a verificação, o número do destinatário deverá ser selecionado no campo Para. Repita esse processo se quiser adicionar outro destinatário, sem ultrapassar o limite de 5 números no total.
Etapa 3: enviar uma mensagem de teste
Envie a mensagem de modelo pré-aprovada hello_world ao número do destinatário escolhido.
No painel WhatsApp > Configuração da API:
- Confirme que seu número de telefone comercial de teste aparece selecionado no campo De.
- Selecione o número de telefone do destinatário para o qual você quer enviar a mensagem no campo Para. Se houver mais de um número adicionado, será possível enviar várias mensagens de uma vez.
- No painel Enviar mensagens com a API, clique no botão Enviar mensagem.
Outra opção é copiar o comando cURL, colar em uma nova janela de terminal e depois executá-lo.
Observe que o código indica que você está enviando uma mensagem de modelo (”type”:”template”) e identificando um modelo específico para usar (”name”:”hello_world”).
Etapa 4: clonar nosso app de exemplo e configurar webhooks
Com os webhooks, você pode receber notificações HTTP em tempo real sobre mudanças em objetos específicos. No WhatsApp, os webhooks podem notificar você sobre diferentes eventos ocorridos no app, como entrega de mensagens, notificações de leitura e até mesmo alterações na conta.
Adicione um URL de retorno de chamada para ver o conteúdo dos webhooks. Siga o guia Exemplo de URL de retorno de chamada para testar webhooks para clonar nosso app de exemplo, que aceita notificações de webhooks e exibe as respectivas cargas JSON na tela.
Depois que seu webhook estiver configurado, reenvie o modelo de mensagem e responda a ele. Quatro notificações de webhook diferentes serão exibidas: as notificações de envio, entrega e leitura da mensagem, além do conteúdo da mensagem recebida.
Etapa 5: adicionar um número comercial real (opcional)
Com as versões de teste do número comercial e da conta do WhatsApp Business, você pode começar a desenvolver seu app. O uso desses ativos de teste permite que você não pague para enviar mensagens enquanto trabalha no processo de desenvolvimento.
Quando estiver tudo pronto para começar a enviar mensagens aos seus clientes, você poderá adicionar um número de telefone comercial real no painel Configuração da API e criar uma conta real do WhatsApp Business.