Consultorio Live icon

Consultorio Live

Interagir com a API do Consultorio Live para gestão de clínicas e consultórios
Join our community

Actions20

Overview

The node "Consultorio Live" integrates with the Consultorio Live API, which is designed for managing clinics and medical offices. Specifically, the "Agendamento" (Appointment) resource with the "Criar" (Create) operation allows users to create new appointment records in the system.

This node is beneficial in scenarios where a clinic or healthcare provider wants to automate scheduling appointments directly from their workflow automation platform. For example, after collecting patient information via a form, this node can be used to schedule an appointment with a professional, specifying date, time, duration, and other details.

Practical examples:

  • Automatically creating a new patient appointment when a booking form is submitted.
  • Scheduling follow-up consultations based on previous visit data.
  • Integrating appointment creation into broader clinical workflows, such as billing or notifications.

Properties

Name Meaning
Dados Do Agendamento A collection of fields describing the appointment details:
- Data Da Consulta The date of the appointment (required).
- Duração (Minutos) Duration of the appointment in minutes (default 30).
- Horário Time of the appointment in HH:MM format (required).
- ID Do Paciente Identifier of the patient for whom the appointment is scheduled (required).
- ID Do Profissional Identifier of the professional who will conduct the appointment (required).
- Observações Optional notes or observations about the appointment.
- Status Status of the appointment; options include: "Agendado" (Scheduled), "Confirmado" (Confirmed), "Cancelado" (Cancelled), "Concluído" (Completed). Default is "Agendado".
- Tipo Type of consultation (optional string).

Output

The node outputs JSON data representing the created appointment record as returned by the Consultorio Live API. This typically includes all the appointment details sent plus any additional metadata or identifiers assigned by the API upon creation.

No binary data output is indicated.

Dependencies

  • Requires connection to the Consultorio Live API.
  • Needs an API authentication credential configured in n8n (an API key or token).
  • The base URL for the API is taken from the credential configuration.
  • The node sends requests with Accept: application/json and Content-Type: application/json headers.

Troubleshooting

  • Common issues:

    • Missing required fields such as appointment date, time, patient ID, or professional ID will likely cause errors.
    • Incorrectly formatted date or time values may result in API validation errors.
    • Authentication failures if the API credential is invalid or missing.
    • Network connectivity problems preventing access to the API endpoint.

  • Error messages:

    • Validation errors indicating which required field is missing or malformed.
    • Authentication errors suggesting to check API credentials.
    • HTTP errors like 404 or 500 indicating endpoint or server issues.

  • Resolutions:

    • Ensure all required properties are provided and correctly formatted.
    • Verify that the API credential is properly set up and has necessary permissions.
    • Check network connectivity and API availability.
    • Review API documentation for correct field formats and constraints.

Links and References

  • Consultorio Live official API documentation (not provided here, but recommended to consult for detailed API specs).
  • n8n documentation on creating and configuring API credentials.
  • General best practices for date/time formatting in APIs.

Discussion