Gestor Clientes Max - Agendamento icon

Gestor Clientes Max - Agendamento

Gerenciar agendamentos: criar, buscar, atualizar e deletar agendamentos via API. Use para operações de scheduling e consultas.

Actions4

Overview

This node, "Gestor Clientes Max - Agendamento," manages scheduling appointments through an external API. It supports creating, retrieving, updating, and deleting appointment records. The node is useful in scenarios where you need to automate appointment management workflows, such as booking consultations, managing client schedules, or integrating appointment data with other systems.

For example, you can use this node to:

  • Automatically create new appointments when a user books a consultation on your website.
  • Retrieve all scheduled appointments for reporting or synchronization purposes.
  • Update appointment details like status or priority based on changes in your CRM.
  • Delete canceled appointments from the system.

The "Create" operation specifically allows you to add a new appointment with details such as title, description, start/end times, status, client association, price, and priority.

Properties

Name Meaning
Título Title of the appointment (required).
Descrição Description of the appointment (optional).
Data/Hora Início Start date and time of the appointment (required).
Data/Hora Fim End date and time of the appointment (required).
Status Status of the appointment. Options: "Agendado" (Scheduled), "Confirmado" (Confirmed), "Concluído" (Completed), "Cancelado" (Canceled). Default is "Agendado".
Client ID (Opcional) Optional numeric ID of the client associated with the appointment.
Preço da Consulta Price of the consultation as a string formatted like "150.00" (optional).
Prioridade Priority of the appointment. Options: "Normal", "Alta" (High), "Baixa" (Low). Default is "Normal".

Output

The node outputs JSON data representing the response from the API after creating the appointment. This typically includes the newly created appointment's details such as its unique ID, timestamps, status, and any other metadata returned by the API.

If an error occurs during execution, the output JSON will contain an error field with the error message.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating requests to the Gestor Clientes Max API.
  • The node makes HTTP requests to the API endpoint defined by the base URL in the credentials.
  • Proper configuration of the API key credential within n8n is necessary for successful operation.

Troubleshooting

  • Common issues:

    • Invalid or missing API key credential will cause authentication failures.
    • Incorrect date/time formats for start or end times may result in API errors.
    • Required fields not provided (e.g., title, startTime, endTime) will cause validation errors.
    • Network connectivity problems can prevent communication with the API.

  • Error messages:

    • "Unknown operation: create": Indicates the operation parameter was not recognized; ensure it is set correctly.
    • API error responses are passed through and appear in the output's error field; check the message for details.

  • Resolutions:

    • Verify that the API key credential is correctly configured and active.
    • Ensure all required properties are filled with valid values.
    • Confirm network access to the API endpoint.
    • Review API documentation for correct data formats and constraints.

Links and References

Discussion