RD Station CRM Campanhas icon

RD Station CRM Campanhas

Consultar campanhas no RD Station CRM

Actions2

Overview

This node allows you to interact with campaigns in the RD Station CRM system. Specifically, for the "Campanha" resource and the "Listar" operation, it fetches a list of campaigns from RD Station CRM based on various filtering and pagination parameters.

Common scenarios where this node is useful include:

  • Retrieving all active marketing campaigns to analyze their performance.
  • Fetching campaigns filtered by status or search terms to integrate with other marketing tools.
  • Paginating through large sets of campaigns to synchronize data with external databases or dashboards.

For example, you might use this node to get the first 50 active campaigns ordered by name ascending, or to search campaigns containing a specific keyword in their title.

Properties

Name Meaning
Limite Maximum number of campaigns to return (number).
Página Page number of results to return (number).
Ordenação Field to order the results by; options: "Nome" (name), "Data de Criação" (created_at).
Direção da Ordenação Direction of ordering; options: "Ascendente" (asc), "Descendente" (desc).
Status Filter campaigns by status; options: "Ativa" (active), "Inativa" (inactive), "Todas" (all).
Termo de Busca Search term to filter campaigns by name (string).

These properties are grouped under "Parâmetros de Listagem" and allow fine control over which campaigns are retrieved and how they are sorted.

Output

The node outputs an array of JSON objects, each representing a campaign or a set of campaigns returned by the API.

  • The main output field is json, which contains the response body from the RD Station CRM API.
  • For the "Listar" operation, this typically includes a list of campaigns matching the specified filters and pagination.
  • Each item in the output corresponds to one input item processed, paired accordingly.
  • There is no binary data output.

Example structure of the output JSON might look like:

{
  "campaigns": [
    {
      "id": "123",
      "name": "Campaign A",
      "status": "active",
      "created_at": "2023-01-01T12:00:00Z",
      ...
    },
    ...
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 200
  }
}

(Note: The exact fields depend on the RD Station CRM API response.)

Dependencies

  • Requires an API key credential for RD Station CRM authentication configured in n8n.
  • Makes HTTP GET requests to the RD Station CRM API endpoint at https://crm.rdstation.com/api/v1/campaigns.
  • Uses the n8n helper method for authenticated requests.

Troubleshooting

  • Missing or invalid campaign ID: When using the "Obter" operation (not requested here), if the campaign ID is missing or invalid, the node throws an error indicating a valid campaign ID must be provided.
  • API request failures: Network issues or invalid credentials may cause request errors. Ensure the API key credential is correctly set up and has necessary permissions.
  • Empty results: If filters are too restrictive (e.g., status or query term), the node may return an empty list.
  • Pagination issues: Requesting pages beyond available data will result in empty responses; verify page numbers and limits.

To resolve errors, check credentials, input parameters, and network connectivity.

Links and References

Discussion