> ## Documentation Index
> Fetch the complete documentation index at: https://doc.apicomponente.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Valida Números de WhatsApp

> Verifica se uma lista de números possui WhatsApp ativo, retornando um JSON com o status de cada número.

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

```delphi theme={null}
// 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.