SacNews - Relacionamento

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

Actions59

Overview

The node "SacNews - Relacionamento" integrates with a customer relationship platform via WhatsApp, enabling various operations related to contacts, messaging, protocols, groups, marketing campaigns, and extra data lookups. Specifically, the operation Contato - Pesquisar ("getContactSearch") allows users to search for contacts using multiple filter types such as keyword, region, operator, gender, email, date period, and others.

This node is beneficial in scenarios where you need to programmatically query and retrieve contact information from the platform based on flexible criteria. For example, a marketing automation workflow could use this node to find all contacts from a specific region or those who have birthdays within a certain period, then send them personalized messages.

Properties

Name	Meaning
Buscar Contatos	Notice informing that this operation allows searching contacts based on different filters.
Paginação (p)	Page number for paginated contact search results.
Tipo De Filtro	Type of filter to apply for searching contacts. 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 type (e.g., name, number, UF, email). Required for filters: Keyword, Region, Operator, Gender, Email, Birthdays.
Data Inicial	Start date for filtering contacts by registration period. Required when filter type is Period.
Data Final	End date for filtering contacts by registration period. Required when filter type is Period.

Output

The node outputs an array of JSON objects representing the contacts matching the search criteria. Each object contains contact details as returned by the platform's API. The exact structure depends on the platform but typically includes fields like contact name, phone number, email, tags, status, and other metadata.

No binary data output is indicated for this operation.

Dependencies

Requires connection to the SacNews customer relationship platform via WhatsApp.
Needs an API authentication token or API key credential configured in n8n to authorize requests.
The node relies on internal action methods imported from bundled dependencies to perform the actual API calls.

Troubleshooting

Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Using incompatible filter parameters (e.g., missing required search parameter for a filter) may result in errors or empty results.
- Pagination values out of range might return no data or errors.
- Date format errors for the period filter can cause request failures.
Error messages:
- Authentication errors: Check that the API key or token is correctly set up in n8n credentials.
- Validation errors: Ensure all required properties for the chosen filter are provided and correctly formatted.
- Network or API errors: Verify connectivity and API endpoint availability.

Links and References

No direct external links were found in the source code.
For more details, consult the SacNews platform API documentation or support resources.