.NET WhatsApp Cloud API

· Componentes

A partir do sgcWebSockets 2022.6.0, a WhatsApp Cloud API é compatível para .NET.

Envie e receba mensagens usando uma versão hospedada em nuvem da WhatsApp Business Platform. A Cloud API permite implementar as APIs do WhatsApp Business sem o custo de hospedagem dos seus próprios servidores e também permite escalar mais facilmente sua mensageria de negócios. A Cloud API suporta até 80 mensagens por segundo de envio e recebimento combinados (inclusive mensagens de texto e mídia).

A WhatsApp Business API permite que empresas médias e grandes se comuniquem com seus clientes em escala. Usando a API, as empresas podem construir sistemas que conectam milhares de clientes com agentes ou bots, viabilizando comunicação tanto programática quanto manual. Além disso, você pode integrar a API a vários sistemas backend, como plataformas de CRM e de marketing.

Recursos 

As empresas obterão todos os novos recursos mais rapidamente na Cloud API. Atualmente, a WhatsApp Business Cloud API vem com todos os recursos disponíveis na WhatsApp Business API.

Recursos úteis da WhatsApp Cloud API:

Primeiros passos 

Para enviar e receber uma primeira mensagem usando um número de teste, complete os seguintes passos:

1. Configure os Developer Assets e o acesso à plataforma

No App Dashboard, clique no app que você gostaria de conectar ao WhatsApp. Role para baixo para encontrar o produto "WhatsApp" e clique em Set up.

Em seguida, você verá a opção de selecionar um Business Manager existente (se tiver um) ou, se preferir, o processo de onboarding pode criar um automaticamente para você (você pode personalizar seu negócio depois, se necessário). Faça uma seleção e clique em Continue.

Quando você clica em Continue, o processo de onboarding realiza as seguintes ações:

2. Envie uma mensagem de teste

Agora, você pode abrir sua IDE e criar um novo projeto. Solte um componente TsgcWhatsapp_Client e preencha as seguintes propriedades:

Uma vez que essas 2 propriedades tenham sido devidamente configuradas, chame o método SendTest para enviar sua primeira mensagem para um número de telefone usando a Whatsapp Business Platform.

TsgcWhatsapp_Client oClient = new TsgcWhatsapp_Client();
oClient.WhatsappOptions.PhoneNumberId = "107809351952205";
oClient.WhatsappOptions.Token = "EAAO4OpgZAs98BAGj3nCFGr...ZB2t8mmLB2LRXJkte2Y5PMNh2";
oClient.SendTest("34605889421");

3. Configure um Webhook

Para ser alertado quando receber uma mensagem ou quando o status de uma mensagem mudar, você precisa configurar um endpoint de Webhook para seu app. Configurar os Webhooks não afeta o status do seu número de telefone e não interfere no envio ou recebimento de mensagens.

Para começar, primeiro você precisa criar o endpoint, então primeiro configure a propriedade ServerOptions do componente WhatsApp Client e configure as seguintes propriedades:

Depois de configurar o servidor, você pode usar o método StartServer para iniciar o servidor e aceitar as requisições que chegarem.

TsgcWhatsapp_Client oClient = TsgcWhatsapp_Client.Create();
oClient.ServerOptions.WebhookOptions.Endpoint = "/webhook";
oClient.ServerOptions.WebhookOptions.Token = "MySecretToken";
oClient.StartServer();

Quando seu endpoint estiver pronto, vá ao seu App Dashboard.

No App Dashboard, encontre o produto WhatsApp e clique em Configuration. Em seguida, encontre a seção webhooks e clique em Configure a webhook. Após o clique, um diálogo aparece na sua tela e pede dois itens:

Depois de adicionar as informações, clique em Verify and Save.

De volta ao App Dashboard, clique em WhatsApp > Configuration no painel à esquerda. Em Webhooks, clique em Manage. Uma caixa de diálogo se abrirá com todos os objetos sobre os quais você pode receber notificações. Para receber mensagens dos seus usuários, clique em Subscribe para messages.

4. Receba uma mensagem de teste

Toda vez que uma nova mensagem é recebida, o evento do cliente OnMessageReceived será chamado.

void OnWhatsAppMessageReceived(TsgcWhatsApp_Client Sender, TsgcWhatsApp_Receive_Message Message, ref bool MarkAsRead)
{
  DoLog("Message Received: [" + Message.From + "] " + Message.Text);
  MarkAsRead = true;
}


Agora que seu Webhook está configurado, envie uma mensagem para o número de teste que você usou. Você deve receber imediatamente uma notificação do Webhooks com o conteúdo da sua mensagem!

Veja abaixo um Demo público online de WhatsApp Bot; basta enviar qualquer mensagem de texto para começar.

WhatsApp Bot

Construído com a biblioteca sgcWebSockets, envie qualquer mensagem de texto e o bot mostrará uma lista de opções ou ecoará sua mensagem de texto. https://www.esegece.com/demo/whatsapp

Veja abaixo o Demo compilado do WhatsApp para Windows.