Cliente WhatsApp Cloud API — sgcWebSockets | eSeGeCe

WhatsApp Cloud API

Envie mensagens de template, texto, mídia e interativas pela WhatsApp Cloud API a partir de Delphi/C++Builder. Inclui um listener HTTPS de Webhook integrado para eventos de entrada.

TsgcWhatsApp_Client

Cliente Delphi/C++Builder para a WhatsApp Business Cloud API. Envie mensagens por HTTPS e hospede um endpoint de Webhook para eventos de entrega e status.

Classe do componente

TsgcWhatsApp_Client

Protocolo

WhatsApp Cloud API

Plataformas

Windows, macOS, Linux, iOS, Android

Edição

Standard / Professional / Enterprise

Configure o token, envie mensagens, hospede o Webhook

Defina WhatsAppOptions.Token e PhoneNumberId, chame um método SendMessage... para enviar e, em seguida, use StartServer e o evento OnMessageReceived para receber respostas.

uses
  sgcLibs;

var
  WhatsApp: TsgcWhatsApp_Client;
begin
  WhatsApp := TsgcWhatsApp_Client.Create(nil);
  WhatsApp.WhatsAppOptions.PhoneNumberId := '123456789012345';
  WhatsApp.WhatsAppOptions.Token := 'EAAG...';

  WhatsApp.SendMessageText('+34666555444', 'hello from Delphi');

  WhatsApp.OnMessageReceived := WhatsAppMessageReceived;
  WhatsApp.StartServer;
end;

procedure TForm1.WhatsAppMessageReceived(Sender: TObject;
  const aMessage: TsgcWhatsApp_Receive_Message;
  var aMarkAsRead: Boolean);
begin
  Memo1.Lines.Add(aMessage.RawMessage);
  aMarkAsRead := True;
end;
// include: sgcLibs.hpp

TsgcWhatsApp_Client *WhatsApp = new TsgcWhatsApp_Client(this);
WhatsApp->WhatsAppOptions->PhoneNumberId = "123456789012345";
WhatsApp->WhatsAppOptions->Token = "EAAG...";

WhatsApp->SendMessageText("+34666555444", "hello from Delphi");

WhatsApp->OnMessageReceived = WhatsAppMessageReceived;
WhatsApp->StartServer();

void __fastcall TForm1::WhatsAppMessageReceived(TObject *Sender,
    TsgcWhatsApp_Receive_Message * const aMessage, bool &aMarkAsRead)
{
  Memo1->Lines->Add(aMessage->RawMessage);
  aMarkAsRead = true;
}

O que tem dentro

Combina um cliente HTTPS da Cloud API com um servidor HTTPS de Webhook integrado, para que um único processo Delphi lide com o tráfego de saída e de entrada.

Envio de mensagens

SendMessageText, SendMessageTemplate, SendMessageImage/Document/Audio/Video, SendMessageInteractiveList, SendMessageInteractiveButtons, SendMessageLocation e SendMessageContact cobrem os principais tipos de conteúdo da Cloud API.

Listener de Webhook

O componente inicia seu próprio servidor HTTPS embutido (StartServer/StopServer, configurado através de ServerOptions) para hospedar o webhook de verificação e entrega exigido pela Meta. OnMessageReceived e OnMessageSent entregam eventos tipados, e OnRawMessage expõe o JSON bruto.

Autenticação

Autenticação OAuth Bearer via WhatsAppOptions.Token; o handshake de verificação do webhook é conferido automaticamente contra ServerOptions.WebhookOptions.Token, e OnBeforeSubscribe dá à sua aplicação mais uma chance de aceitar ou rejeitar a inscrição.

Parâmetros de template

SendMessageTemplate aceita parâmetros nomeados/posicionais e código de idioma, e o componente monta a estrutura tipada exigida pela Meta.

Upload de mídia

Chame SendFileImage, SendFileDocument, SendFileAudio, SendFileVideo ou SendFileSticker com o caminho de um arquivo local; o componente faz o upload através de UploadMedia e referencia o media id retornado automaticamente. DownloadMedia e DeleteMedia gerenciam os recursos já existentes nos servidores da Meta.

Webhook protegido por TLS

Configure ServerOptions.SSLOptions para o webhook de entrada — a Meta exige que ele seja acessível por TLS. O TLSOptions de nível superior cobre separadamente as chamadas HTTPS de saída para a Graph API.

Especificações e referências

Fontes oficiais para a API que este componente implementa.

Documentação e demos

Acesse a referência do componente, baixe o projeto de demonstração pronto para executar e obtenha a versão de avaliação.

Ajuda online — API_Whatsapp Referência completa de propriedades, métodos e eventos deste componente.
Projeto de demonstração — Demos\50.Other\05.WhatsApp Projeto de exemplo pronto para executar. Vem dentro do pacote sgcWebSockets — baixe a versão de avaliação abaixo.
Documento técnico (PDF) Recursos, início rápido, exemplos de código para Delphi e C++ Builder e referências oficiais — apenas este componente.
Manual do usuário (PDF) Manual completo cobrindo cada componente da biblioteca.
Melhor custo-benefício: All-AccessTodos os produtos da eSeGeCe, com Suporte Premium incluído, a partir de €1,059/ano.
Ver preços do All-Access

Pronto para enviar mensagens WhatsApp?

Baixe a avaliação gratuita e integre a WhatsApp Cloud API em suas aplicações Delphi.