.NET WhatsApp Cloud-API

· Componenten

Vanaf sgcWebSockets 2022.6.0 wordt de WhatsApp Cloud-API ondersteund voor .NET.

Verstuur en ontvang berichten via een cloud-gehoste versie van het WhatsApp Business Platform. Met de Cloud-API kun je WhatsApp Business-API's implementeren zonder de kosten van het hosten van je eigen servers en kun je je business messaging gemakkelijker schalen. De Cloud-API ondersteunt tot 80 berichten per seconde aan gecombineerd versturen en ontvangen (inclusief tekst- en mediaberichten).

De WhatsApp Business-API stelt middelgrote en grote bedrijven in staat om op grote schaal met hun klanten te communiceren. Met de API kunnen bedrijven systemen bouwen die duizenden klanten verbinden met agents of bots, en die zowel programmatische als handmatige communicatie mogelijk maken. Daarnaast kun je de API integreren met talloze backend-systemen zoals CRM- en marketingplatforms.

Functies 

Bedrijven krijgen alle nieuwe functies sneller via de Cloud-API. Op dit moment biedt de WhatsApp Business Cloud-API alle functies die ook beschikbaar zijn in de WhatsApp Business-API.

Nuttige functies van de WhatsApp Cloud-API:

Aan de slag 

Om je eerste bericht te verzenden en te ontvangen met een testnummer, doorloop je de volgende stappen:

1. Stel je developer-assets en platform-toegang in

Klik in het App-dashboard op de app die je met WhatsApp wilt verbinden. Scroll omlaag om het "WhatsApp"-product te vinden en klik op Set up.

Vervolgens zie je de optie om een bestaande Business Manager te selecteren (als je die hebt) of, indien je wilt, kan het onboardingproces er automatisch een voor je aanmaken (je kunt je bedrijf later aanpassen indien nodig). Maak een keuze en klik op Continue.

Wanneer je op Continue klikt, voert het onboardingproces het volgende uit:

2. Verstuur een testbericht

Nu kun je je IDE openen en een nieuw project maken. Plaats een TsgcWhatsapp_Client-component en vul de volgende eigenschappen in:

Zodra deze 2 eigenschappen correct zijn geconfigureerd, roep je de methode SendTest aan om je eerste bericht naar een telefoonnummer te sturen via het WhatsApp Business Platform.

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

3. Configureer een webhook

Om gewaarschuwd te worden wanneer je een bericht ontvangt of wanneer de status van een bericht is gewijzigd, moet je een webhook-endpoint instellen voor je app. Het instellen van webhooks heeft geen invloed op de status van je telefoonnummer en verstoort het verzenden of ontvangen van berichten niet.

Om te beginnen moet je eerst het endpoint maken. Configureer dus eerst de eigenschap ServerOptions van het WhatsApp-client-component en configureer de volgende eigenschappen:

Nadat je de server hebt geconfigureerd, kun je de methode StartServer aanroepen om de server te starten en inkomende requests te accepteren.

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

Zodra je endpoint klaar is, ga je naar je App-dashboard.

Zoek in je App-dashboard het WhatsApp-product op en klik op Configuration. Zoek vervolgens het Webhooks-gedeelte en klik op Configure a webhook. Na de klik verschijnt er een dialoogvenster op je scherm dat naar twee zaken vraagt:

Klik na het invoeren van de gegevens op Verify and Save.

Terug in het App-dashboard klik je in het linkerpaneel op WhatsApp > Configuration. Klik onder Webhooks op Manage. Er wordt een dialoogvenster geopend met alle objecten waarover je een melding kunt krijgen. Om berichten van je gebruikers te ontvangen, klik je op Subscribe bij messages.

4. Ontvang een testbericht

Elke keer dat er een nieuw bericht binnenkomt, wordt het client-event OnMessageReceived aangeroepen.

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


Nu je webhook is ingesteld, verstuur je een bericht naar het testnummer dat je hebt gebruikt. Je krijgt direct een webhook-melding met de inhoud van je bericht!

Hieronder vind je een publieke online WhatsApp Bot-demo. Stuur een willekeurig tekstbericht om te beginnen.

WhatsApp Bot

Gebouwd met de sgcWebSockets-bibliotheek. Stuur een willekeurig tekstbericht en de bot toont een lijst met opties of echoot je tekstbericht. https://www.esegece.com/demo/whatsapp

Hieronder vind je de gecompileerde WhatsApp-demo voor Windows.