Relacio - WhatsApp icon

Relacio - WhatsApp

Interação com a Plataforma de Relacionamento via WhatsApp - Relacio
Join our community

Actions58

Overview

The node provides integration with a WhatsApp-based customer relationship platform called "Relacio." Specifically, the "Contato - Pesquisar" (Contact - Search) operation allows users to search for contacts using various filters such as keyword, region, operator, gender, email, and date ranges. This operation is useful for scenarios where you need to retrieve specific contact information from a large database based on different criteria, enabling targeted communication or data analysis.

Practical examples include:

  • Searching contacts by name or phone number to send personalized messages.
  • Filtering contacts registered within a specific period for campaign targeting.
  • Finding contacts by region or operator to analyze regional engagement.

Properties

Name Meaning
Buscar Contatos Notice indicating that this operation allows searching contacts with different filters.
Paginação (p) Page number for paginated contact search results. Required numeric input.
Tipo De Filtro Type of filter to apply for the contact search. Options:
- Palavra Chave (Keyword)
- Região (Region)
- Operadora (Operator)
- Gênero (Gender)
- Portabilidade (Portability)
- Bloqueados (Blocked)
- Período (Period)
- Importados (Imported)
- E-Mail
- Leads
- Aniversariantes (Birthdays)
Parâmetro De Busca Search parameter value corresponding to the selected filter (e.g., name, number, UF, email). Required string input. Shown only for filters: Keyword, Region, Operator, Gender, Email, Birthdays.
Data Inicial Start date for the registration period filter. Required datetime input. Shown only if filter is "Período".
Data Final End date for the registration period filter. Required datetime input. Shown only if filter is "Período".

Output

The output consists of JSON data representing the list of contacts matching the specified search criteria and pagination. Each contact entry typically includes details such as contact identifiers, names, phone numbers, tags, and other relevant metadata retrieved from the platform.

If the node supports binary data output (not explicitly shown in the provided code), it would represent media or files associated with contacts, but this operation primarily returns structured JSON contact data.

Dependencies

  • Requires an API key credential to authenticate with the Relacio WhatsApp platform.
  • The node depends on internal action modules (imported as a from "./actions") which implement the actual API calls.
  • No additional external services are indicated beyond the Relacio platform API.

Troubleshooting

  • Common Issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Providing invalid filter parameters or missing required fields (e.g., missing start/end dates when filtering by period) may result in errors.
    • Pagination values out of range might return empty results or errors.

  • Error Messages:

    • Authentication errors typically indicate invalid or expired API keys; verify and update credentials.
    • Validation errors occur if required parameters are missing or incorrectly formatted; ensure all required inputs are provided according to the filter type.
    • Network or API errors may happen due to connectivity issues; retry or check network settings.

Links and References

Discussion