Tidi Node icon

Tidi Node

Nós oficiais da plataforma de agendamentos Tidi.

Actions4

Overview

This node integrates with the Tidi scheduling platform, providing access to partner information, services, professionals, and schedule availability. The "Verificar Disponibilidade" (Check Availability) operation specifically allows users to verify the availability of a professional's schedule for given services.

Common scenarios where this node is beneficial include:

  • Automating appointment booking workflows by checking if a professional is available before confirming a booking.
  • Integrating scheduling data into CRM or calendar systems.
  • Building custom dashboards that display real-time availability of service providers.

For example, a user can input a professional's ID and a list of service IDs to check when that professional is available to perform those services, enabling dynamic scheduling decisions.

Properties

Name Meaning
Idioma Language for the request; options are "Português" (pt) and "Inglês" (en).
ID Do Profissional The unique identifier of the professional whose availability is being checked.
Serviços A JSON array string containing the IDs of the services to check availability for.

Output

The node outputs an array of items, each containing a json object with the following structure:

{
  "operation": "checkAvailability",
  "success": true,
  "data": { /* response from Tidi API about availability */ },
  "metadata": {
    "endpoint": "/{language}/integration/partner/schedule/availability",
    "method": "POST",
    "timestamp": "ISO 8601 timestamp"
  }
}
  • operation: The operation performed ("checkAvailability").
  • success: Boolean indicating if the request was successful.
  • data: The detailed availability information returned by the Tidi API.
  • metadata: Contains endpoint path, HTTP method used, and timestamp of the request.

The node does not output binary data.

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.
  • The user must configure the API key credential in n8n prior to using this node.

Troubleshooting

  • Invalid Professional ID or Service IDs: If the provided professional ID or service IDs are incorrect or do not exist, the API may return errors or empty availability data. Verify these IDs before running the node.
  • Malformed Services JSON: The "Serviços" property expects a JSON array string (e.g., ["serviceId1", "serviceId2"]). Invalid JSON will cause the request body to be malformed, resulting in API errors.
  • API Key Issues: Missing or invalid API keys will cause authentication failures. Ensure the API key credential is correctly set up.
  • Unknown Operation Error: If an unsupported operation is selected, the node throws an error indicating "Operação desconhecida". This should not occur if only supported operations are chosen.
  • Network or API Downtime: Network issues or Tidi API downtime will cause request failures. Check connectivity and Tidi status.

Links and References

Discussion