izapp - WhatsApp icon

izapp - WhatsApp

Interação com a Plataforma de Relacionamento via WhatsApp - IZapp

Actions58

Overview

The node provides an interface to search contacts within a WhatsApp relationship platform using various filters. It enables users to query contacts based on criteria such as keywords, region, operator, gender, email, and specific date ranges, among others. This operation is useful for marketing campaigns, customer support segmentation, or data analysis where filtering contacts by different attributes is necessary.

For example, a user could search for all contacts registered in a particular region or find contacts who have birthdays within a certain period. Another practical use case is filtering contacts by their phone operator or identifying blocked contacts.

Properties

Name Meaning
Buscar Contatos Notice informing that this operation allows searching contacts with different filters.
Paginação Page number for paginated contact search results (required).
Tipo De Filtro Type of filter to apply for the contact search. Options: Palavra Chave, Região, Operadora, Gênero, Portabilidade, Bloqueados, Período, Importados, E-Mail, Leads, Aniversariantes.
Parâmetro De Busca Search parameter value corresponding to the selected filter (e.g., name, number, UF, operator, email). Required for filters: Palavra Chave, Região, Operadora, Gênero, E-Mail, Aniversariantes.
Data Inicial Start date for the registration period filter. Required when filter type is Período.
Data Final End date for the registration period filter. Required when filter type is Período.

Output

The output is a JSON array containing the search results of contacts matching the specified filters and pagination. Each item in the array represents a contact with its associated details as returned by the platform's API.

If the node supports binary data output for this operation, it is not indicated in the provided code or properties; thus, the output is primarily structured JSON data representing contact information.

Dependencies

  • Requires an API key credential to authenticate requests to the external WhatsApp relationship platform.
  • The node depends on internal action methods imported from a bundled actions module, which handle the actual API calls for contact searching.
  • No additional environment variables or external services are explicitly required beyond the configured API authentication.

Troubleshooting

  • Common issues:

    • Incorrect or missing API credentials will prevent successful contact searches.
    • Providing invalid or mismatched filter parameters (e.g., missing required search values for certain filters) may cause errors or empty results.
    • Pagination parameters outside the valid range might result in no data returned.
  • Error messages:

    • Authentication failures typically indicate problems with the API key or token; verify credentials in the node configuration.
    • Validation errors related to missing required fields (like search parameters or dates) should be resolved by ensuring all mandatory inputs are provided according to the selected filter.
    • Network or API endpoint errors suggest connectivity issues or service downtime; retry after confirming network status.

Links and References

  • No direct external links are provided in the source code.
  • For more information about the platform's API and contact search capabilities, consult the official documentation of the WhatsApp relationship platform integrated by this node (not included here).

Discussion