Tidi Node icon

Tidi Node

Nós oficiais da plataforma de agendamentos Tidi.

Actions4

Overview

The "Tidi Node" is designed to interact with the Tidi scheduling platform API, enabling users to retrieve partner information, list services, list professionals, and check availability for appointments. This node is useful in scenarios where automation of scheduling data retrieval or availability checking is needed, such as integrating Tidi scheduling data into workflows for booking systems, CRM updates, or reporting.

Specifically, the Listar Profissionais (List Professionals) operation fetches a list of all professionals associated with the partner account on the Tidi platform. It supports filtering the results by custom fields, allowing users to narrow down the professional list based on specific criteria.

Practical examples:

  • Automatically retrieving updated lists of professionals to sync with an internal database.
  • Filtering professionals by specialty or location before presenting options to end-users.
  • Using the professional list to dynamically populate dropdowns in booking forms.

Properties

Name Meaning
Idioma Language for the request; options are "Português" (pt) or "Inglês" (en).
Filtros Adicionais Additional filters to apply when listing professionals. Each filter consists of:
- Nome Do Campo: The field name to filter by (string).
- Valor: The value to match for that field (string).

Output

The node outputs an array of JSON objects, each corresponding to an input item processed. For the Listar Profissionais operation, each output item contains:

  • operation: The operation performed, here always "getProfessionals".
  • success: Boolean indicating if the API call was successful.
  • data: The raw response data from the Tidi API containing the list of professionals, potentially filtered according to the provided filters.
  • metadata: An object including:
    • endpoint: The API endpoint used (e.g., /pt/integration/partner/professionals).
    • method: HTTP method used (GET).
    • timestamp: ISO timestamp of when the request was made.

If the node encounters an error and is configured to continue on failure, it outputs an object with success: false, an error message, and the timestamp.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating requests to the Tidi platform.
  • The node makes HTTP requests to the Tidi API base URL: https://api.tidi.com.br.
  • Proper configuration of the API key credential within n8n is necessary.
  • The node depends on n8n's HTTP request helper methods and error handling utilities.

Troubleshooting

  • Common issues:

    • Invalid or missing API key will cause authentication failures.
    • Incorrect filter field names or values may result in empty or unexpected results.
    • Network connectivity problems can prevent successful API calls.
    • Using unsupported language codes may lead to API errors.

  • Error messages:

    • "Operação desconhecida: <operation>": Indicates an invalid operation parameter; ensure the operation is set to one of the supported values.
    • HTTP errors returned from the API (e.g., 401 Unauthorized) usually indicate credential issues.
    • JSON parsing errors might occur if the service returns malformed responses.

  • Resolutions:

    • Verify the API key is correctly set and has appropriate permissions.
    • Double-check filter keys and values for correctness.
    • Ensure network access to https://api.tidi.com.br is available.
    • Use the supported language options ("pt" or "en").

Links and References

Discussion