Valida Números de WhatsApp

Esse bloco documenta como validar se uma lista de números possui WhatsApp ativo utilizando o método ApiEuAtendo1.ExistWhats. Ele explica como passar os parâmetros corretamente e exibe um exemplo de código Delphi para realizar a validação e exibir o resultado detalhado.

​

Objetivo da Função

A função ApiEuAtendo1.ExistWhats permite verificar se uma lista de números possui contas ativas no WhatsApp. A função aceita múltiplos números separados por vírgulas e retorna um TJSONArray com detalhes do status de cada número.

​

Passo a Passo para Validar os Números

1. Insira os Números de Telefone separados por vírgula no campo correspondente.
2. Chame a função ExistWhats passando os números.
3. A função retornará um TJSONArray com informações detalhadas sobre cada número, incluindo:
   • exists: Indica se o número possui WhatsApp (true ou false).
   • jid: ID do número no WhatsApp.
   • number: O próprio número consultado.
   • name: Nome associado ao número (se disponível).

​

Exemplo de Código

// Chamar a função para validar se os números possuem WhatsApp
begin
  Numeros := edtNumeroContato.Text; // Assume que edtNumeroContato é um TEdit onde os números são inseridos separados por vírgula
  try
    ResponseArray := ApiEuAtendo1.ExistWhats(Numeros, ErroMsg);
    
    if Assigned(ResponseArray) then
    begin
      // Itera sobre a resposta para cada número
      for i := 0 to ResponseArray.Count - 1 do
      begin
        ResponseItem := ResponseArray.Items[i] as TJSONObject;
        memo1.Lines.Add('Número: ' + ResponseItem.GetValue<string>('number'));
        memo1.Lines.Add('JID: ' + ResponseItem.GetValue<string>('jid'));
        memo1.Lines.Add('Existe no WhatsApp: ' + BoolToStr(ResponseItem.GetValue<Boolean>('exists'), True));
        
        if ResponseItem.TryGetValue<string>('name', ErroMsg) then
          memo1.Lines.Add('Nome: ' + ErroMsg)
        else
          memo1.Lines.Add('Nome: Não disponível');

        memo1.Lines.Add(''); // Linha em branco para separação visual entre os números
      end;
    end
    else if ErroMsg <> '' then
    begin
      memo1.Lines.Add('Erro ao verificar os números: ' + ErroMsg);
    end
    else
    begin
      memo1.Lines.Add('Nenhum número possui WhatsApp.');
    end;
  except
    on E: Exception do
    begin
      memo1.Lines.Add('Erro ao verificar os números: ' + E.Message);
    end;
  end;
end;

​

Parâmetros da Função

• edtNumeroContato.Text: String contendo os números de telefone que você deseja validar, separados por vírgula.

​

Estrutura do Retorno

A função retorna um TJSONArray contendo um TJSONObject para cada número consultado. Cada objeto possui os seguintes campos:

• exists: Boolean – Indica se o número está registrado no WhatsApp.
• jid: String – ID do número no WhatsApp.
• number: String – O número de telefone consultado.
• name: String – Nome associado ao número, se disponível.

​

Tratamento de Erros

Em caso de erro, como problemas de conexão ou formato incorreto dos números, a função preencherá a variável ErroMsg com uma mensagem descritiva. Verifique a mensagem de erro e garanta que os números foram inseridos no formato correto (separados por vírgula) antes de chamar a função.

Essa atualização permite ao usuário validar múltiplos números de forma eficiente e obter um relatório detalhado do status de cada número, facilitando o acompanhamento e a análise dos resultados.