Atendimentos com n8n

Pre-requisitos

• Node NooviChat instalado no n8n (@nooviai/n8n-nodes-noovichat)
• Token de API NooviChat com permissao de agente ou administrador
• Feature flag appointments_module ativa na conta
• Ao menos um profissional e um servico configurados

Configurar Credencial

No n8n, crie uma credencial do tipo NooviChat API com:

1. Abra o n8n → Credenciais → Nova Credencial
2. Selecione NooviChat API
3. Preencha Base URL: https://chat.seudominio.com
4. Preencha API Token: seu api_access_token
5. Preencha Account ID: ID numerico da sua conta
6. Clique em Salvar

Receber Eventos (Trigger)

Use o node NooviChat Trigger para iniciar um workflow quando um atendimento mudar de status. O node cadastra automaticamente o webhook e verifica a assinatura HMAC.

1. Adicione o node NooviChat Trigger como primeiro no workflow
2. Selecione a credencial criada
3. Em Events, selecione os eventos desejados, por exemplo: appointment_created, appointment_confirmed
4. Ative o workflow — o n8n exibira a URL do webhook

O payload recebido pelo trigger contem os mesmos campos documentados em Formato do payload.

Criar Agendamento via n8n

Use o node NooviChat com recurso Appointment e operacao Createpara criar um agendamento a partir de dados de outro node (formulario, CRM, Typeform etc.).

Exemplo de expressao n8n para os campos:

// Campo: contact_id
{{ $json.contact_id }}

// Campo: professional_id  (pode vir de um node anterior)
{{ $node["Buscar Profissional"].json.data.id }}

// Campo: service_id
{{ $json.service_id || 7 }}  // valor padrao se nao fornecido

// Campo: scheduled_at (converter data local para UTC ISO8601)
{{ DateTime.fromISO($json.date + 'T' + $json.time + ':00', { zone: 'America/Sao_Paulo' }).toUTC().toISO() }}

Fluxo Completo: Confirmacao Automatica via WhatsApp

Este exemplo cria um fluxo que: (1) recebe o evento de agendamento criado, (2) confirma automaticamente e (3) envia mensagem WhatsApp ao paciente.

Dica: exporte o workflow como JSON e importe no seu n8n para comecar rapidamente. O template estara disponivel na galeria publica de templates NooviChat.

Listar Disponibilidade

Para oferecer opcoes de horario ao usuario antes de criar o agendamento, use o node NooviChat com recurso Professional e operacao Get Availability.

// Configuracao do node "Get Availability":
// Resource: Professional
// Operation: Get Availability
// Professional ID: {{ $json.professional_id }}
// Date: {{ $json.date }}  // formato: 2026-06-15
// Service ID (opcional): {{ $json.service_id }}

// Saida do node — slots disponiveis:
// [
//   { "start": "2026-06-15T08:00:00Z", "end": "2026-06-15T09:00:00Z", "available": true },
//   { "start": "2026-06-15T09:00:00Z", "end": "2026-06-15T10:00:00Z", "available": false },
//   ...
// ]

// Filtrar apenas slots livres:
{{ $json.data.slots.filter(s => s.available) }}

Exemplos de Automacao