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 AccessToken e PhoneNumberId, vincule o servidor de WebHook a um TsgcWebSocketHTTPServer, então use SendMessage para saída e OnInboundMessage para respostas.

uses
  sgcLibs;

var
  WA: TsgcWhatsApp_Client;
begin
  WA := TsgcWhatsApp_Client.Create(nil);
  WA.CloudOptions.AccessToken     := 'EAAG...';
  WA.CloudOptions.PhoneNumberId   := '123456789012345';
  WA.CloudOptions.VerifyToken     := 'my-webhook-secret';

  WA.OnInboundMessage := procedure(Sender: TObject;
    const aFrom, aText: string)
  begin
    Memo1.Lines.Add(aFrom + ': ' + aText);
  end;

  WA.Active := True;

  WA.SendTextMessage('+34666555444', 'hello from Delphi');
end;
// uses: sgcLibs
TsgcWhatsApp_Client *WA = new TsgcWhatsApp_Client(this);
WA->CloudOptions->AccessToken   = "EAAG...";
WA->CloudOptions->PhoneNumberId = "123456789012345";

WA->Active = true;
WA->SendTextMessage("+34666555444", "hello from Delphi");

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 entrada e saída.

Envio de mensagens

SendTextMessage, SendTemplateMessage, SendMediaMessage, SendInteractiveMessage, SendLocationMessage e SendContactMessage cobrem os principais tipos de conteúdo da Cloud API.

Listener de Webhook

O componente embute um TsgcWebSocketHTTPServer para hospedar o webhook de verificação + entrega exigido pela Meta. OnInboundMessage e OnStatusUpdate entregam eventos tipados.

Autenticação

Autenticação OAuth Bearer via CloudOptions.AccessToken; a verificação do verify-token acontece automaticamente contra CloudOptions.VerifyToken na primeira chamada GET do webhook.

Parâmetros de template

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

Upload de mídia

O componente cuida do upload de mídia multi-etapas da Cloud API (upload → obter media-id → referenciar no envio) ao chamar SendMediaMessage com um caminho de arquivo local.

Webhook protegido por TLS

Configure as SSLOptions do servidor embutido para HTTPS — a Meta exige que o Webhook seja acessível por TLS. O WatchDog cuida da reassociação de porta na rotação de certificados.

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.

Pronto para enviar mensagens WhatsApp?

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