Exemplos Delphi - WhatsApp API

Este diretório contém exemplos de como usar a API WhatsApp SaaS com Delphi.

📁 Arquivos

• WhatsAppAPI.pas: Unit com a classe TWhatsAppAPI para comunicação com a API
• ExemploUso.dpr: Exemplo console simples
• ExemploForm.pas: Exemplo com interface gráfica (Form)

🔧 Requisitos

• Delphi 7 ou superior (testado com Delphi 10.3+)
• Componentes Indy instalados (TIdHTTP, TIdSSLIOHandlerSocketOpenSSL)
• Acesso à internet

📦 Instalação

1. Adicione WhatsAppAPI.pas ao seu projeto
2. Adicione as units necessárias ao uses:
   • System.Classes
   • System.JSON
   • System.NetEncoding
   • IdHTTP
   • IdSSLOpenSSL
   • System.SysUtils

🚀 Uso Básico

uses
  WhatsAppAPI;

var
  API: TWhatsAppAPI;
  Response: string;
begin
  // Criar instância
  API := TWhatsAppAPI.Create(
    'https://seu-dominio.com',  // Base URL
    'seu-token-aqui',           // Token da instância
    'seu-session-id-aqui'       // Session ID
  );
  
  try
    // Enviar mensagem de texto
    Response := API.SendTextMessage(
      '5511999999999@c.us',  // Número do WhatsApp
      'Olá! Mensagem de teste'  // Mensagem
    );
    
    WriteLn(Response);
  finally
    API.Free;
  end;
end;

📝 Exemplos

Exemplo Console (ExemploUso.dpr)

Programa console simples que demonstra:

• Verificar status da sessão
• Verificar se número está no WhatsApp
• Enviar mensagem de texto
• Enviar imagem por URL
• Enviar localização

Como compilar:

dcc32 ExemploUso.dpr

Como executar:

ExemploUso.exe

Exemplo Form (ExemploForm.pas)

Interface gráfica com:

• Campos para configurar API (URL, Token, Session ID)
• Campo para número do destinatário
• Campo para mensagem
• Botões para:
  • Conectar
  • Verificar status
  • Enviar texto
  • Enviar imagem
  • Enviar localização
• Log de operações

Nota: Você precisará criar o arquivo .dfm correspondente ou usar o Form Designer do Delphi.

🔑 Obtendo Token e Session ID

1. Acesse o dashboard: https://seu-dominio.com/dashboard.html
2. Faça login
3. Crie uma instância ou selecione uma existente
4. Copie o Token e o Session ID

📞 Formato do Número

O número deve estar no formato:

código_do_país + número + @c.us

Exemplos:

• Brasil: 5511999999999@c.us (55 = código do Brasil)
• EUA: 11234567890@c.us (1 = código dos EUA)

⚠️ Tratamento de Erros

Sempre verifique o campo success na resposta JSON:

var
  JSON: TJSONObject;
begin
  JSON := TJSONObject.ParseJSONValue(Response) as TJSONObject;
  try
    if JSON.GetValue<Boolean>('success', False) then
      WriteLn('Sucesso!')
    else
      WriteLn('Erro: ' + JSON.GetValue<string>('message', ''));
  finally
    JSON.Free;
  end;
end;

🐛 Troubleshooting

Erro de SSL/TLS

Certifique-se de que o TIdSSLIOHandlerSocketOpenSSL está configurado corretamente e que as DLLs do OpenSSL estão disponíveis.

Erro 401 (Não autorizado)

• Verifique se o token está correto
• Verifique se a instância está ativa
• Verifique se o Session ID está correto

Erro 404 (Sessão não encontrada)

• Verifique se o Session ID está correto
• Verifique se a sessão está iniciada e conectada

📚 Métodos Disponíveis

• SendTextMessage: Enviar mensagem de texto
• SendImage: Enviar imagem (arquivo local)
• SendImageFromURL: Enviar imagem por URL
• SendDocument: Enviar documento/arquivo
• SendLocation: Enviar localização
• GetSessionStatus: Verificar status da sessão
• IsRegisteredUser: Verificar se número está no WhatsApp
• GetContacts: Obter lista de contatos
• GetChats: Obter lista de chats

🔒 Segurança

• Nunca compartilhe seu token
• Use HTTPS em produção
• Mantenha o token seguro no código ou em arquivo de configuração

📞 Suporte

Para mais informações, consulte:

• Manual completo da API
• Documentação da API em /api-docs