Atendimentos com n8n

Pré-requisitos

• Node NooviChat instalado no n8n (@nooviai/n8n-nodes-noovichat)
• Token de API NooviChat com permissão de agente ou administrador
• Licença NooviChat válida com Atendimentos configurado operacionalmente na conta
• Ao menos um profissional e um serviço 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 numérico 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, quando a credencial opcional de webhook tem um secret configurado, valida a assinatura HMAC.

1. Adicione o node NooviChat Trigger como primeiro no workflow
2. Selecione a credencial criada
3. Em Event, selecione o evento desejado, por exemplo: appointment.created ou appointment.confirmed
4. Ative o workflow — o n8n exibirá a URL do webhook

O payload recebido pelo trigger contém os mesmos campos documentados em Formato do payload.

Criar Agendamento via n8n

Use o node NooviChat com recurso Appointment e operação Createpara criar um agendamento a partir de dados de outro node (formulário, CRM, Typeform etc.).

Exemplo de expressão 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: Confirmação Automática 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 começar rapidamente. O template estará disponível na galeria pública de templates NooviChat.

Listar Disponibilidade

Para oferecer opções de horário ao usuário antes de criar o agendamento, use o node NooviChat com recurso Appointment e operação Get Availability.

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

// Saida do node — todos os valores em data.slots ja estao disponiveis:
// {
//   "data": {
//     "date": "2026-06-15",
//     "professional_id": 3,
//     "slots": ["2026-06-15T08:00:00-03:00", "2026-06-15T09:00:00-03:00"]
//   }
// }

{{ $json.data.slots }}

Exemplos de Automação