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 checking availability, listing professionals and services, obtaining partner information, and creating appointments. The "Verificar Disponibilidade" (Check Availability) operation specifically allows users to verify the availability of a professional for certain services, which is useful in scenarios like booking appointments or managing schedules dynamically.

Practical examples:

  • A business wanting to check if a specific professional is available for selected services before confirming an appointment.
  • Automating availability checks within a workflow to prevent double bookings.
  • Integrating with external systems to display real-time availability to customers.

Properties

Name Meaning
Idioma Language for the request; options: "Português" (pt), "Inglês" (en).
ID Do Profissional The unique identifier of the professional whose availability is being checked.
Serviços JSON array string containing IDs of the services to check availability for (e.g., ["serviceId1", "serviceId2"]).

Output

The node outputs a JSON object with the following structure:

{
  "operation": "checkAvailability",
  "success": true,
  "data": { /* response data 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: Contains the availability information returned by the Tidi API for the specified professional and services.
  • metadata: Includes details about the API endpoint used, HTTP method, and the 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.
  • Proper configuration of the API key credential in n8n is necessary for successful operation.

Troubleshooting

  • Common issues:

    • Invalid or missing API key credential will cause authentication failures.
    • Incorrect professional ID or service IDs may result in empty or error responses.
    • Malformed JSON string in the "Serviços" property can cause request errors.
    • Network connectivity issues can prevent communication with the Tidi API.

  • Error messages:

    • "Operação desconhecida": Indicates an unsupported operation was selected; ensure "Verificar Disponibilidade" is chosen.
    • API error responses are included in the error details; review these for specifics such as invalid parameters or quota limits.
    • If the node throws errors related to request formatting, verify that the "Serviços" input is a valid JSON array string.

  • Resolution tips:

    • Double-check the API key credential setup.
    • Validate all input fields, especially JSON arrays.
    • Use the "continue on fail" option to handle errors gracefully in workflows.

Links and References

Discussion