Tidi Node icon

Tidi Node

Nós oficiais da plataforma de agendamentos Tidi.

Actions5

Overview

This node integrates with the Tidi scheduling platform, enabling users to interact with various scheduling-related operations such as listing professionals, listing services, checking availability, scheduling appointments, and retrieving partner information. It is useful for automating appointment management workflows, syncing scheduling data, or building custom booking interfaces.

For the Listar Profissionais operation specifically, the node fetches a list of all professionals associated with the partner account on the Tidi platform. This can be used to display available professionals in a booking system or to synchronize professional data with other systems.

Practical Example

  • A business wants to automatically retrieve and display all their service professionals on their website booking page.
  • An integration workflow that updates an internal CRM with the latest list of professionals from Tidi.

Properties

Name Meaning
Idioma Language for the request. Options: "Português" (pt), "Inglês" (en).
Filtros Adicionais Additional filters to narrow down the list of professionals. Each filter has:
- Nome Do Campo: The field name to filter by (string).
- Valor: The value to match for the given field (string).

The additional filters allow dynamic filtering of professionals based on arbitrary fields and values, enhancing flexibility in querying.

Output

The output JSON object contains:

  • operation: The operation performed, e.g., "getProfessionals".
  • success: Boolean indicating if the API call was successful.
  • data: The raw response data returned by the Tidi API for the requested operation (in this case, the list of professionals).
  • metadata: An object containing:
    • endpoint: The API endpoint path used.
    • method: HTTP method used (GET or POST).
    • timestamp: ISO timestamp of when the request was made.

No binary data output is produced by this node.

Example output snippet for Listar Profissionais:

{
  "operation": "getProfessionals",
  "success": true,
  "data": [ /* array of professional objects from Tidi API */ ],
  "metadata": {
    "endpoint": "/pt/integration/partner/professionals",
    "method": "GET",
    "timestamp": "2024-06-01T12:00:00.000Z"
  }
}

Dependencies

  • Requires an API key credential for authenticating requests to the Tidi platform.
  • The node makes HTTP requests to the Tidi API at https://api.tidi.com.br.
  • No additional external dependencies are required beyond standard n8n HTTP request helpers.

Troubleshooting

  • Common Issues:

    • Invalid or missing API key will cause authentication failures.
    • Incorrect filter keys or values may result in empty or unexpected results.
    • Network connectivity issues can cause request timeouts or errors.

  • Error Messages:

    • "Operação desconhecida: <operation>" — indicates an unsupported operation was selected; verify the operation name.
    • HTTP error responses from the API are surfaced with details if available, helping diagnose issues like invalid parameters or quota limits.

  • Resolution Tips:

    • Ensure the API key credential is correctly configured and active.
    • Double-check filter field names and values against the Tidi API documentation.
    • Use the node's "Continue On Fail" option to handle errors gracefully in workflows.

Links and References

Discussion