Actions26
Overview
This node integrates with the Dental Office Cloud API to manage scheduling (agendamento) of appointments within a dental clinic. Specifically, the "Criar" (Create) operation under the "Agendamento" (Schedule) resource allows users to create new appointment records by specifying details such as clinic ID, chair ID, dentist(s), patient, start time, and other optional metadata.
This node is beneficial in scenarios where dental clinics want to automate appointment creation workflows, synchronize scheduling data between systems, or build custom booking interfaces integrated with their existing Dental Office Cloud setup.
Practical examples:
- Automatically creating an appointment when a patient books online.
- Scheduling follow-up visits after a treatment is completed.
- Coordinating multiple dentists' schedules for group appointments.
Properties
| Name | Meaning |
|---|---|
| ID da Clínica | Numeric identifier of the clinic where the appointment will be scheduled. |
| ID da Cadeira | Numeric identifier of the chair (dental unit) assigned for the appointment. |
| ID do Dentista | Numeric identifier of the primary dentist responsible for the appointment. |
| IDs dos Dentistas | Comma-separated list of numeric identifiers for multiple dentists involved in the appointment. |
| ID do Paciente | Numeric identifier of the patient for whom the appointment is scheduled. |
| Data e Hora do Agendamento | Date and time indicating the start of the appointment. |
| Agendamento Pessoal | Boolean flag indicating if the appointment is a personal one for the dentist. |
| Descrição | Text description or notes related to the appointment. |
| Situação do Agendamento | Current status of the appointment; options include Confirmar (1), Confirmado (2), Em Atendimento (3), Atendido (4), Faltou (5), Cancelado (6). |
Output
The output JSON contains the response from the Dental Office Cloud API representing the newly created appointment record. This typically includes all details of the appointment such as its unique ID, associated clinic, chair, dentist(s), patient, start time, status, description, and any other metadata returned by the API.
No binary data output is produced by this node.
Dependencies
- Requires an active connection to the Dental Office Cloud API.
- The node expects an API authentication token or API key credential configured in n8n to authorize requests.
- Proper permissions on the API side to create schedule entries are necessary.
Troubleshooting
- Invalid JSON format errors: Some properties accept JSON strings (not applicable here but relevant in other operations). Ensure JSON inputs are well-formed.
- Missing required parameters: Clinic ID, Chair ID, and Schedule Start date/time are mandatory. Omitting these will cause errors.
- API authentication failures: Verify that the API credentials are correctly set up and have not expired.
- Invalid IDs or references: Using non-existent clinic, chair, dentist, or patient IDs will result in API errors.
- Status value errors: The schedule situation must be one of the predefined options; invalid values will cause request rejection.
Links and References
- Dental Office Cloud API documentation (for schedules): Dental Office API Docs
- n8n documentation on creating custom nodes: https://docs.n8n.io/integrations/creating-nodes/
- General REST API best practices: https://restfulapi.net/
If you need further details about other operations or resources, feel free to ask!