RD Station CRM

Creates a new segment used for classifying organizations. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`segments_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `segments_list` → get ID → call `segments_create`. Plano mínimo: Todos os planos Limites de uso: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. Quando esta tool falhar: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. O que a IA deve fazer: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

segments_create

Creates a new deal source, allowing tracking of new acquisition channels. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`sources_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `sources_list` → get ID → call `sources_create`. Plano mínimo: Todos os planos Limites de uso: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. Quando esta tool falhar: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. O que a IA deve fazer: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

sources_create

Creates a follow-up task on a deal (`deal_id`). Use this for next step / outreach (e.g. a draft email). Tasks can only be created with `open` status. Status is `open` or `done` — not a pipeline/lead status. Requires an existing deal from `deals_create`. After success, return the CRM id — do not invent the record in chat. <pre_requisites> - Use `users_list` to find the user list with their corresponding IDs </pre_requisites> **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`tasks_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `tasks_list` → get ID → call `tasks_create`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

tasks_create

Retrieves a specific campaign by its unique ID. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`campaigns_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `campaigns_list` → get ID → call `campaigns_get`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

campaigns_get

Retrieves a paginated list of all contacts in the account, with filtering options. **Endpoint:** `GET https://api.rd.services/crm/v2/contacts` ## Response (required) Every item in `data[]` **always includes `id`**. Always show `id` for each contact (together with name/email/phone). Never omit `id` from the answer or from a follow-up tool call. ## RDQL syntax (`filter` parameter) Format: `field:value` (do not include the `filter=` prefix in the string — only the RDQL value). **Operators:** equals (`status:won`), not (`-status:won`), comparison (`total_price:>1000`, `created_at:>=2024-01-01`), IN (`status:(won,lost)`), regex (`name:~Silva`), implicit AND, OR (`or`), groups `( … ) and …`. **Types:** string, number, date (`2024-01-01`), datetime (`""2024-01-01 12:00:00""`), array `(a,b)`. **Custom fields:** `@slug` prefix (e.g. `@department:technology`). **API base:** `GET https://api.rd.services/crm/v2{path}` ## Filterable fields (this tool) | Field | Type | Usage | |-------|------|-------| | `name` | String | `name:~John` | | `email`, `phone`, `job_title` | String | exact match or `~` | | `organization_id` | String | linked company | | `created_at`, `updated_at` | DateTime | date ranges | | `@slug` | String | custom field | ## Sort (`sort` parameter) Pass an **object** mapping a field to `asc` or `desc`. Never an array or a bare field name — `["created_at"]` is ignored and list order becomes unstable. **This tool:** `name`, `created_at`. **Newest first / "last N" contacts (required):** `{ "created_at": "desc" }` Without `sort`, the same request can return different contacts. ## Pagination (`page` parameter) Object: `number` (default 1), `size` (default 25). Last 10 contacts: `page: { "size": 10 }` **and** `sort: { "created_at": "desc" }`. ## Examples for this tool - Exact email: `email:[email protected]` - Partial name: `name:~Silva` - Created after Jan 1, 2024: `created_at:>=2024-01-01` - Last 10 contacts: `sort: { "created_at": "desc" }`, `page: { "size": 10 }` - Created in August 2026: `created_at:>=2026-08-01 created_at:<2026-09-01` with `sort: { "created_at": "desc" }` Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

contacts_get

Retrieves a specific custom field by its unique ID. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`custom_fields_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `custom_fields_list` → get ID → call `custom_fields_get`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

custom_fields_get

Retrieves a specific deal by its unique ID. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`deals_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `deals_list` → get ID → call `deals_get`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

deals_get

Retrieves a specific stage from a specific sales pipeline. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`funnel_stages_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `funnel_stages_list` → get ID → call `funnel_stages_get`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

funnel_stages_get

Retrieves a specific lost reason by its unique ID. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`lost_reasons_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `lost_reasons_list` → get ID → call `lost_reasons_get`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

lost_reasons_get

Retrieves a specific organization by its unique ID. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`organizations_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `organizations_list` → get ID → call `organizations_get`. Plano mínimo: Todos os planos Limites de uso: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. Quando esta tool falhar: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. O que a IA deve fazer: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

organizations_get

Retrieves complete information for a specific product by its unique ID. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`products_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `products_list` → get ID → call `products_get`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

products_get

Retrieves a specific sales pipeline by its unique ID. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`funnel_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `funnel_list` → get ID → call `funnels_get`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

funnels_get

Retrieves a specific organization segment by its unique ID. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`segments_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `segments_list` → get ID → call `segments_get`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

segments_get

Retrieves a specific deal source by its unique ID. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`sources_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `sources_list` → get ID → call `sources_get`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

sources_get

Retrieves a specific task by its unique ID. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`tasks_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `tasks_list` → get ID → call `tasks_get`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

tasks_get

Retrieves a specific team by its ID, including the list of its member user IDs. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`teams_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `teams_list` → get ID → call `teams_get`. Plano mínimo: Todos os planos Limites de uso: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. Quando esta tool falhar: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. O que a IA deve fazer: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

teams_get

Retrieves a specific user by their unique ID. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`users_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `users_list` → get ID → call `users_get`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

users_get

Lists all campaigns in the account, allowing for filtering and pagination. **Endpoint:** `GET https://api.rd.services/crm/v2/campaigns` ## RDQL syntax (`filter` parameter) Format: `field:value` (do not include the `filter=` prefix in the string — only the RDQL value). **Operators:** equals (`status:won`), not (`-status:won`), comparison (`total_price:>1000`, `created_at:>=2024-01-01`), IN (`status:(won,lost)`), regex (`name:~Silva`), implicit AND, OR (`or`), groups `( … ) and …`. **Types:** string, number, date (`2024-01-01`), datetime (`""2024-01-01 12:00:00""`), array `(a,b)`. **Custom fields:** `@slug` prefix (e.g. `@department:technology`). **API base:** `GET https://api.rd.services/crm/v2{path}` ## Filterable fields (this tool) | Field | Type | Usage | |-------|------|-------| | `name` | String | `name:~Webinar` | | `created_at`, `updated_at` | DateTime | dates | ## Examples for this tool - Campaign by name: `name:~Black Friday` - Created in 2024: `created_at:>=2024-01-01` Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

campaigns_list

Retrieves a paginated list of all contacts in the account, with filtering options. **Endpoint:** `GET https://api.rd.services/crm/v2/contacts` ## Response (required) Every item in `data[]` **always includes `id`**. Always show `id` for each contact (together with name/email/phone). Never omit `id` from the answer or from a follow-up tool call. ## RDQL syntax (`filter` parameter) Format: `field:value` (do not include the `filter=` prefix in the string — only the RDQL value). **Operators:** equals (`status:won`), not (`-status:won`), comparison (`total_price:>1000`, `created_at:>=2024-01-01`), IN (`status:(won,lost)`), regex (`name:~Silva`), implicit AND, OR (`or`), groups `( … ) and …`. **Types:** string, number, date (`2024-01-01`), datetime (`""2024-01-01 12:00:00""`), array `(a,b)`. **Custom fields:** `@slug` prefix (e.g. `@department:technology`). **API base:** `GET https://api.rd.services/crm/v2{path}` ## Filterable fields (this tool) | Field | Type | Usage | |-------|------|-------| | `name` | String | `name:~John` | | `email`, `phone`, `job_title` | String | exact match or `~` | | `organization_id` | String | linked company | | `created_at`, `updated_at` | DateTime | date ranges | | `@slug` | String | custom field | ## Sort (`sort` parameter) Pass an **object** mapping a field to `asc` or `desc`. Never an array or a bare field name — `["created_at"]` is ignored and list order becomes unstable. **This tool:** `name`, `created_at`. **Newest first / "last N" contacts (required):** `{ "created_at": "desc" }` Without `sort`, the same request can return different contacts. ## Pagination (`page` parameter) Object: `number` (default 1), `size` (default 25). Last 10 contacts: `page: { "size": 10 }` **and** `sort: { "created_at": "desc" }`. ## Examples for this tool - Exact email: `email:[email protected]` - Partial name: `name:~Silva` - Created after Jan 1, 2024: `created_at:>=2024-01-01` - Last 10 contacts: `sort: { "created_at": "desc" }`, `page: { "size": 10 }` - Created in August 2026: `created_at:>=2026-08-01 created_at:<2026-09-01` with `sort: { "created_at": "desc" }` Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

contacts_list

Lists custom fields, allowing filtering by entity (deal, contact, etc.). **Endpoint:** `GET https://api.rd.services/crm/v2/custom_fields` ## RDQL syntax (`filter` parameter) Format: `field:value` (do not include the `filter=` prefix in the string — only the RDQL value). **Operators:** equals (`status:won`), not (`-status:won`), comparison (`total_price:>1000`, `created_at:>=2024-01-01`), IN (`status:(won,lost)`), regex (`name:~Silva`), implicit AND, OR (`or`), groups `( … ) and …`. **Types:** string, number, date (`2024-01-01`), datetime (`""2024-01-01 12:00:00""`), array `(a,b)`. **Custom fields:** `@slug` prefix (e.g. `@department:technology`). **API base:** `GET https://api.rd.services/crm/v2{path}` ## Filterable fields (this tool) | Field | Type | Usage | |-------|------|-------| | `entity` / API filters | String | e.g. fields for `deal`, `contact` (per API docs) | | `name` | String | field name | ## Examples for this tool - Deal fields: use `entity` filter as supported by the API - Before filtering deals with `@slug`, list real slugs with this tool **Note:** Use to discover valid `@` slugs before filtering deals/contacts. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

custom_fields_list

Lists all notes associated with a specific deal. ## Filter Properties available for filtering using RDQL. - registered_at (DateTime): Filters by note registration date and time. - user_id (String): Filters by the ID of the user who created the note. - is:pinned (Boolean): Filters notes that have been pinned. ## Sorting Properties available for sorting: - registered_at **Endpoint:** `GET https://api.rd.services/crm/v2/deals/{deal_id}/notes` ## RDQL Requires `deal_id`. No global RDQL filter — lists notes for one deal. Get `deal_id` via `deals_list` with RDQL, then call this tool. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

deals_notes_list

Lists all products associated with a specific deal. **Endpoint:** `GET https://api.rd.services/crm/v2/deals/{deal_id}/products` ## RDQL Requires `deal_id`. Lists products linked to a deal. Filter deals with `deals_list`, then list products for the deal. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

deals_products_list

Retrieves a paginated list of all deals, allowing filtering by pipeline, stage, or owner. ## Filter Properties available for filtering using RDQL. - id (String): Filters by one or more deal IDs. - name (String): Filters by deal name, supporting exact or pattern matching (using match operator `~`). - rating (Integer): Filters by deal numeric rating value. - status (String): Filters by deal status. - closed_at (DateTime): Filters by deal closing date and time. - created_at (DateTime): Filters by deal creation date and time. - updated_at (DateTime): Filters by deal last update date and time. - expected_close_date (Date): Filters by deal expected closing date. - organization_id (String): Filters by organization ID. - stage_id (String): Filters by sales pipeline stage ID. - lost_reason_id (String): Filters by deal lost reason ID. - campaign_id (String): Filters by campaign ID. - owner_id (String): Filters by deal owner (user) ID. - pipeline_id (String): Filters deals by sales pipeline ID. - product_ids (String): Filters deals containing one or more product IDs. - has:product (Boolean): Filters deals that have associated products. - @<custom_field_slug> (String): Filters by custom field. Example: `branch:north`, `erp_id:123`. ## Sorting Properties available for sorting: - name - rating - created_at - updated_at - closed_at **Endpoint:** `GET https://api.rd.services/crm/v2/deals` ## RDQL syntax (`filter` parameter) Format: `field:value` (do not include the `filter=` prefix in the string — only the RDQL value). **Operators:** equals (`status:won`), not (`-status:won`), comparison (`total_price:>1000`, `created_at:>=2024-01-01`), IN (`status:(won,lost)`), regex (`name:~Silva`), implicit AND, OR (`or`), groups `( … ) and …`. **Types:** string, number, date (`2024-01-01`), datetime (`""2024-01-01 12:00:00""`), array `(a,b)`. **Custom fields:** `@slug` prefix (e.g. `@department:technology`). **API base:** `GET https://api.rd.services/crm/v2{path}` ## Filterable fields (this tool) | Field | Type | Usage | |-------|------|-------| | `status` | String | `won`, `lost`, `open` | | `name` | String | `name:~Silva` | | `total_price` | Number | `total_price:>5000` (verify support on account) | | `created_at`, `updated_at`, `closed_at` | DateTime | `created_at:>=2024-01-01` | | `pipeline_id`, `stage_id`, `owner_id` | String | pipeline/stage/owner IDs | | `@slug` | String | custom field | ## Examples for this tool - Won deals: `status:won` - Name contains Silva: `name:~Silva` - Won or lost in 2024: `(status:won or status:lost) and created_at:>=2024-01-01` - Won above $2,000: `status:won total_price:>2000` **Note:** Lists **deals**, not contacts. Use `contacts_list` for people. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

deals_list

Lists all stages for a specific sales pipeline. ## Ordenação Propriedades disponíveis para [ordenação](crm-v2-introduction#ordenação). * `order` **Endpoint:** `GET https://api.rd.services/crm/v2/pipelines/{pipeline_id}/stages` ## RDQL Requires pipeline ID. Lists stages for the pipeline. Use stage IDs in `deals_list` as `stage_id:ID`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

funnel_stages_list

Retrieves the list of all configured lost reasons in the account. ## Filter Properties available for filtering using RDQL. - name (String): Filters by lost reason name. ## Sorting Properties available for sorting: - name - created_at **Endpoint:** `GET https://api.rd.services/crm/v2/lost_reasons` ## RDQL syntax (`filter` parameter) Format: `field:value` (do not include the `filter=` prefix in the string — only the RDQL value). **Operators:** equals (`status:won`), not (`-status:won`), comparison (`total_price:>1000`, `created_at:>=2024-01-01`), IN (`status:(won,lost)`), regex (`name:~Silva`), implicit AND, OR (`or`), groups `( … ) and …`. **Types:** string, number, date (`2024-01-01`), datetime (`""2024-01-01 12:00:00""`), array `(a,b)`. **Custom fields:** `@slug` prefix (e.g. `@department:technology`). **API base:** `GET https://api.rd.services/crm/v2{path}` ## Filterable fields (this tool) | Field | Type | Usage | |-------|------|-------| | `name` | String | lost reason name | ## Examples for this tool - Price reason: `name:~price` Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

lost_reasons_list

Retrieves a paginated list of all organizations in the account. ## Filter Properties available for filtering using RDQL. - name (String): Filters by organization name. - owner_id (String): Filters by owner ID. - segment_ids (String): Filters by one or more segment IDs. - created_at (DateTime): Filters by organization creation date and time. - updated_at (DateTime): Filters by organization last update date and time. - @<custom_field_slug> (String): Filters by custom field. Example: `cnpj:11.111.111/0001-11`, `erp_id:123`. ## Sorting Properties available for sorting: - name - created_at - updated_at **Endpoint:** `GET https://api.rd.services/crm/v2/organizations` ## RDQL syntax (`filter` parameter) Format: `field:value` (do not include the `filter=` prefix in the string — only the RDQL value). **Operators:** equals (`status:won`), not (`-status:won`), comparison (`total_price:>1000`, `created_at:>=2024-01-01`), IN (`status:(won,lost)`), regex (`name:~Silva`), implicit AND, OR (`or`), groups `( … ) and …`. **Types:** string, number, date (`2024-01-01`), datetime (`""2024-01-01 12:00:00""`), array `(a,b)`. **Custom fields:** `@slug` prefix (e.g. `@department:technology`). **API base:** `GET https://api.rd.services/crm/v2{path}` ## Filterable fields (this tool) | Field | Type | Usage | |-------|------|-------| | `name` | String | `name:~Acme` or exact | | `segment_id` | String | organization segment | | `created_at`, `updated_at` | DateTime | dates | | `@slug` | String | custom field | ## Examples for this tool - Name contains Tech: `name:~Tech` - By segment: `segment_id:abc123` Plano mínimo: Todos os planos Limites de uso: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. Quando esta tool falhar: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. O que a IA deve fazer: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

organizations_list

Retrieves the catalog of all products or services the company sells. ## Filter Properties available for filtering using RDQL. - name (String): Filters products by name. Supports exact match only. - is:visible (Boolean): Filters products that are visible. - @<custom_field_slug> (String): Filters by custom field. Example: `color:blue`, `erp_id:123`. ## Sorting Properties available for sorting: - name **Endpoint:** `GET https://api.rd.services/crm/v2/products` ## RDQL syntax (`filter` parameter) Format: `field:value` (do not include the `filter=` prefix in the string — only the RDQL value). **Operators:** equals (`status:won`), not (`-status:won`), comparison (`total_price:>1000`, `created_at:>=2024-01-01`), IN (`status:(won,lost)`), regex (`name:~Silva`), implicit AND, OR (`or`), groups `( … ) and …`. **Types:** string, number, date (`2024-01-01`), datetime (`""2024-01-01 12:00:00""`), array `(a,b)`. **Custom fields:** `@slug` prefix (e.g. `@department:technology`). **API base:** `GET https://api.rd.services/crm/v2{path}` ## Filterable fields (this tool) | Field | Type | Usage | |-------|------|-------| | `name` | String | `name:~Plan` | | `price` | Number | `price:>100` (if supported) | | `created_at` | DateTime | dates | ## Examples for this tool - Product by name: `name:~Premium` - Price above 100: `price:>100` Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

products_list

Lists all sales pipelines in the account. ## Sorting Properties available for sorting: - order **Endpoint:** `GET https://api.rd.services/crm/v2/pipelines` ## RDQL Lists sales pipelines. Use pagination (`page`, `per_page`); RDQL on `filter` may not apply. To filter deals by pipeline: `deals_list` with `pipeline_id:ID` Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

funnel_list

Retrieves the list of all configured organization segments. ## Filter Properties available for filtering using RDQL. - name (String): Filters segments by name. ## Sorting Properties available for sorting: - name **Endpoint:** `GET https://api.rd.services/crm/v2/segments` ## RDQL syntax (`filter` parameter) Format: `field:value` (do not include the `filter=` prefix in the string — only the RDQL value). **Operators:** equals (`status:won`), not (`-status:won`), comparison (`total_price:>1000`, `created_at:>=2024-01-01`), IN (`status:(won,lost)`), regex (`name:~Silva`), implicit AND, OR (`or`), groups `( … ) and …`. **Types:** string, number, date (`2024-01-01`), datetime (`""2024-01-01 12:00:00""`), array `(a,b)`. **Custom fields:** `@slug` prefix (e.g. `@department:technology`). **API base:** `GET https://api.rd.services/crm/v2{path}` ## Filterable fields (this tool) | Field | Type | Usage | |-------|------|-------| | `name` | String | organization segment | ## Examples for this tool - Enterprise segment: `name:~Enterprise` Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

segments_list

Retrieves the list of all configured deal sources. ## Filter Properties available for filtering using RDQL. - name (String): Filters sources by name. ## Sorting Properties available for sorting: - name **Endpoint:** `GET https://api.rd.services/crm/v2/sources` ## RDQL syntax (`filter` parameter) Format: `field:value` (do not include the `filter=` prefix in the string — only the RDQL value). **Operators:** equals (`status:won`), not (`-status:won`), comparison (`total_price:>1000`, `created_at:>=2024-01-01`), IN (`status:(won,lost)`), regex (`name:~Silva`), implicit AND, OR (`or`), groups `( … ) and …`. **Types:** string, number, date (`2024-01-01`), datetime (`""2024-01-01 12:00:00""`), array `(a,b)`. **Custom fields:** `@slug` prefix (e.g. `@department:technology`). **API base:** `GET https://api.rd.services/crm/v2{path}` ## Filterable fields (this tool) | Field | Type | Usage | |-------|------|-------| | `name` | String | deal source name | ## Examples for this tool - Referral source: `name:~Referral` Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

sources_list

Retrieves a paginated list of tasks, allowing filters for status, type, and owner. ## Filter Properties available for filtering using RDQL. - deal_id (String): Filters by a specific deal ID. - type (String): Filters by task type. - owner_ids (String): Filters by one or more owner IDs. - completed_at (DateTime): Filters by task completion date and time. - due_date (DateTime): Filters by task due date and time. - status (String): Filters by task status. ## Sorting Properties available for sorting: - due_date - deal_id - completed_at - updated_at **Endpoint:** `GET https://api.rd.services/crm/v2/tasks` ## RDQL syntax (`filter` parameter) Format: `field:value` (do not include the `filter=` prefix in the string — only the RDQL value). **Operators:** equals (`status:won`), not (`-status:won`), comparison (`total_price:>1000`, `created_at:>=2024-01-01`), IN (`status:(won,lost)`), regex (`name:~Silva`), implicit AND, OR (`or`), groups `( … ) and …`. **Types:** string, number, date (`2024-01-01`), datetime (`""2024-01-01 12:00:00""`), array `(a,b)`. **Custom fields:** `@slug` prefix (e.g. `@department:technology`). **API base:** `GET https://api.rd.services/crm/v2{path}` ## Filterable fields (this tool) | Field | Type | Usage | |-------|------|-------| | `status`, `type` | String | per account API values | | `owner_id`, `deal_id` | String | IDs | | `due_date`, `created_at` | Date/DateTime | ranges | | `@slug` | String | custom field | ## Examples for this tool - Open tasks: `status:open` - By owner: `owner_id:USER_ID` Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

tasks_list

Lists all teams in the account, including their names and IDs. **Endpoint:** `GET https://api.rd.services/crm/v2/teams` ## RDQL Lists teams. Usually no RDQL filter — use pagination. For members: `teams_get` with team ID. Plano mínimo: Todos os planos Limites de uso: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. Quando esta tool falhar: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. O que a IA deve fazer: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

teams_list

Lists all users in the account, with filters for active or visible status. ## Filter Properties available for filtering using RDQL. - is:active (Boolean): Filters users that are active. - is:visible (Boolean): Filters users that are visible. **Endpoint:** `GET https://api.rd.services/crm/v2/users` ## RDQL syntax (`filter` parameter) Format: `field:value` (do not include the `filter=` prefix in the string — only the RDQL value). **Operators:** equals (`status:won`), not (`-status:won`), comparison (`total_price:>1000`, `created_at:>=2024-01-01`), IN (`status:(won,lost)`), regex (`name:~Silva`), implicit AND, OR (`or`), groups `( … ) and …`. **Types:** string, number, date (`2024-01-01`), datetime (`""2024-01-01 12:00:00""`), array `(a,b)`. **Custom fields:** `@slug` prefix (e.g. `@department:technology`). **API base:** `GET https://api.rd.services/crm/v2{path}` ## Filterable fields (this tool) | Field | Type | Usage | |-------|------|-------| | `is:active` | Boolean | `is:active:true` | | `is:visible` | Boolean | `is:visible:true` | ## Examples for this tool - Active users: `is:active:true` - Active and visible: `is:active:true is:visible:true` Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

users_list

Updates the data of an existing campaign, such as its name or description. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`campaigns_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `campaigns_list` → get ID → call `campaigns_update`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

campaigns_update

Updates the fields of an existing contact. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`contacts_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `contacts_list` → get ID → call `contacts_update`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

contacts_update

Updates a deal's fields. Use this to move a deal between stages or change its owner. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`deals_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `deals_list` → get ID → call `deals_update`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

deals_update

Updates a product that is already associated with a deal, such as its quantity or price. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`deals_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `deals_list` → get ID → call `deals_products_update`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

deals_products_update

Updates the name or display order of an existing stage within a pipeline. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`funnel_stages_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `funnel_stages_list` → get ID → call `funnel_stages_update`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

funnel_stages_update

Updates the name of an existing lost reason. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`lost_reasons_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `lost_reasons_list` → get ID → call `lost_reasons_update`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

lost_reasons_update

Updates the fields of an existing organization. **Endpoint:** ID-based operation or JSON body — does not use RDQL `filter`. To search records by criteria (name, date, status, etc.), use **`organizations_list`** with RDQL syntax on the `filter` parameter. ## RDQL (quick reference) Syntax: `field:value`. Operators: `:>`, `:<`, `:>=`, `:<=`, `~`, `or`, `and`, `(groups)`. Custom: `@slug:value`. Indirect example: filter with `organizations_list` → get ID → call `organizations_update`. Minimum plan: All plans Rate limits: - Até 120 requisições por minuto por conta. Em caso de limite excedido, aguarde pelo menos 60 segundos antes de retentar. When this tool fails: - Erro 401 (Não autorizado) significa "Token de autenticação inválido ou expirado." e a ação sugerida é reconecte a integração OAuth antes de tentar novamente. - Erro 403 (Acesso negado) significa "Credenciais sem permissão para este recurso no CRM." e a ação sugerida é não tente novamente; informe o usuário sobre a falta de permissão. - Erro 404 (Não encontrado) significa "Recurso não encontrado no CRM." e a ação sugerida é verifique o identificador ou liste o recurso antes de atualizar. - Erro 422 (Dados inválidos) significa "Os dados enviados não passaram na validação do CRM." e a ação sugerida é corrija os campos indicados pela API e tente novamente. - Erro 429 (Limite de requisições) significa "Limite de 120 requisições por minuto por conta atingido." e a ação sugerida é aguarde pelo menos 60 segundos antes de tentar novamente. - Erro 500 (Erro interno do servidor) significa "O CRM está temporariamente indisponível." e a ação sugerida é aguarde alguns segundos e tente novamente sem alterar o payload. What the AI should do: - reconecte a integração OAuth antes de tentar novamente - não tente novamente; informe o usuário sobre a falta de permissão - verifique o identificador ou liste o recurso antes de atualizar - corrija os campos indicados pela API e tente novamente - aguarde pelo menos 60 segundos antes de tentar novamente - aguarde alguns segundos e tente novamente sem alterar o payload

organizations_update