NooviChat API Reference

Referencia completa da API NooviChat — 160+ endpoints para customer engagement, conversas, pipeline de vendas, atendimentos (agendamentos), follow-ups, lead scoring e integracao WhatsApp.

Visao Geral

Base URL

https://chat.seudominio.com

Versao

v1.1.0OpenAPI 3.0.4

Autenticacao

Todas as requisicoes requerem o header api_access_token com seu token de acesso.

Ver guia completo de autenticacao

Convencoes

Codigos de status

A API segue um contrato de erro consistente. Entrada invalida nunca retorna 500.

Status	Significado
200 / 201	Sucesso. Algumas rotas legacy retornam 200 na criacao; as canonicas retornam 201.
204	Sucesso sem corpo (ex.: alguns DELETE).
401	Token ausente/invalido (`api_access_token`).
403	Autenticado mas sem permissao (ex.: recurso admin-only).
404	Recurso inexistente ou de outra conta (IDs sao resolvidos dentro da conta autenticada — ver abaixo).
422	Validacao falhou (campo obrigatorio, valor fora de faixa, enum invalido). Corpo: `{ "error" \| "message", ... }`.
429	Rate limit excedido — ver Rate Limits.

IDs sao resolvidos por conta

Todo {id} e display_id e resolvido dentro da conta autenticada. Um ID que pertence a outra conta retorna 404 — nunca os dados de outra conta. display_id e conversation_display_id sao sequencias por conta (contas diferentes podem ter o mesmo #42).

Wrapper do corpo e paginacao

Recursos de escrita esperam o corpo dentro de um wrapper com o nome do recurso (ex.: pipeline_card, pipeline_automation, pipeline_webhook, campaign). A paginacao varia por endpoint: a maioria usa page/per_page com envelope { data, meta }; algumas rotas legacy usam limit/offset ou retornam { payload }. Cada pagina de recurso documenta o formato especifico.

Platform API

Gerenciamento de contas, usuarios e configuracoes da plataforma.

/platform/api/v1/accounts

Criar uma conta

/platform/api/v1/accounts/{id}

Obter detalhes da conta

/platform/api/v1/accounts/{id}

Atualizar conta

/platform/api/v1/accounts/{id}

Deletar conta

Conversas

Gerenciar conversas com clientes nos canais habilitados.

/api/v1/accounts/{id}/conversations

Listar conversas

/api/v1/accounts/{id}/conversations

Criar conversa

/api/v1/accounts/{id}/conversations/{conv_id}

Obter conversa

/api/v1/accounts/{id}/conversations/{conv_id}/toggle_status

Alterar status

Mensagens

Enviar e receber mensagens nas conversas.

/api/v1/accounts/{id}/conversations/{conv_id}/messages

Listar mensagens

/api/v1/accounts/{id}/conversations/{conv_id}/messages

Enviar mensagem

/api/v1/accounts/{id}/conversations/{conv_id}/messages/{msg_id}

Deletar mensagem

Contatos

CRUD de contatos e sincronizacao com CRM.

/api/v1/accounts/{id}/contacts

Listar contatos

/api/v1/accounts/{id}/contacts

Criar contato

/api/v1/accounts/{id}/contacts/{contact_id}

Obter contato

/api/v1/accounts/{id}/contacts/{contact_id}

Atualizar contato

Caixas de Entrada

Gerenciar canais de atendimento habilitados (WhatsApp, web e outros).

/api/v1/accounts/{id}/inboxes

Listar inboxes

/api/v1/accounts/{id}/inboxes

Criar inbox

/api/v1/accounts/{id}/inboxes/{inbox_id}

Atualizar inbox

Equipes e Agentes

Gerenciar equipes de atendimento e agentes.

/api/v1/accounts/{id}/teams

Listar equipes

/api/v1/accounts/{id}/teams

Criar equipe

/api/v1/accounts/{id}/agents

Listar agentes

Automacoes

Regras de automacao, bots e respostas automaticas.

/api/v1/accounts/{id}/automation_rules

Listar regras de automacao

/api/v1/accounts/{id}/automation_rules

Criar regra

Webhooks

Configurar notificacoes de eventos via HTTP.

/api/v1/accounts/{id}/webhooks

Listar webhooks

/api/v1/accounts/{id}/webhooks

Criar webhook

/api/v1/accounts/{id}/webhooks/{webhook_id}

Atualizar webhook

/api/v1/accounts/{id}/webhooks/{webhook_id}

Deletar webhook

Relatorios

Metricas e relatorios de atendimento.

/api/v2/accounts/{id}/reports/agents

Relatorio de agentes

/api/v2/accounts/{id}/reports/conversations

Relatorio de conversas

Pipeline (CRM)

Pipeline de vendas com estagios, cards (deals), automacoes e lead scoring.

/api/v1/accounts/{id}/pipelines

Listar pipelines

/api/v1/accounts/{id}/pipeline_cards

Criar card (deal)

/api/v1/accounts/{id}/pipeline_cards/{card_id}/move_to_stage

Mover card

/api/v1/accounts/{id}/pipeline/cards/{card_id}/deal_status/mark_won

Marcar como ganho

Follow-ups

Acompanhamento automatico de conversas com templates e automacoes.

/api/v1/accounts/{id}/conversations/{conv_id}/follow-ups

Listar follow-ups

/api/v1/accounts/{id}/conversations/{conv_id}/follow-ups

Criar follow-up

/api/v1/accounts/{id}/follow-up-templates

Listar templates

/api/v1/accounts/{id}/follow-up-automations

Criar automacao

Atividades

Tarefas e atividades do pipeline: ligacoes, reunioes, emails.

/api/v1/accounts/{id}/pipeline/activities

Listar atividades

/api/v1/accounts/{id}/pipeline/activities

Criar atividade

/api/v1/accounts/{id}/pipeline/activities/{act_id}/complete

Concluir atividade

Lead Scoring

Pontuacao automatica de leads com regras e analytics.

/api/v1/accounts/{id}/lead_score_rules

Listar regras

/api/v1/accounts/{id}/lead_score_rules

Criar regra

/api/v1/accounts/{id}/pipeline_cards/{card_id}/recalculate_score

Recalcular score

Pipeline Analytics

Dashboard, win rate, velocidade de vendas e performance da equipe.

/api/v1/accounts/{id}/pipeline/analytics/dashboard

Dashboard completo

/api/v1/accounts/{id}/pipeline/analytics/win_rate

Win rate

/api/v1/accounts/{id}/pipeline/analytics/sales_velocity

Velocidade de vendas

Campanhas

Campanhas de marketing e broadcast via WhatsApp e outros canais.

/api/v1/accounts/{id}/campaigns

Listar campanhas

/api/v1/accounts/{id}/campaigns

Criar campanha

SLA

Politicas de nivel de servico e monitoramento de conformidade.

/api/v1/accounts/{id}/sla_policies

Listar politicas SLA

/api/v1/accounts/{id}/sla_policies

Criar politica

/api/v1/accounts/{id}/applied_slas/metrics

Metricas SLA

WAHA

Integracao WhatsApp self-hosted: sessoes, QR code e configuracoes.

/api/v1/accounts/{id}/waha/{inbox_id}/status

Status da sessao

/api/v1/accounts/{id}/waha/{inbox_id}/refresh_qr

Gerar QR code

/api/v1/accounts/{id}/waha/{inbox_id}/reconnect

Reconectar

Atendimentos

Agendamentos clinicos e de servicos: CRUD, confirmacao, reagendamento, disponibilidade e exportacao.

/api/v1/accounts/{id}/appointments

Listar atendimentos

/api/v1/accounts/{id}/appointments

Criar atendimento

/api/v1/accounts/{id}/appointments/{apt_id}/confirm

Confirmar atendimento

/api/v1/accounts/{id}/appointments/availability

Verificar disponibilidade

Profissionais

Profissionais que executam os servicos, com horarios de atendimento e disponibilidade.

/api/v1/accounts/{id}/professionals

Listar profissionais

/api/v1/accounts/{id}/professionals

Criar profissional

/api/v1/accounts/{id}/professionals/{prof_id}/availability

Disponibilidade por data

Servicos

Catalogo de servicos com duracao, preco e templates de lembrete.

/api/v1/accounts/{id}/services

Listar servicos

/api/v1/accounts/{id}/services

Criar servico

/api/v1/accounts/{id}/services/{svc_id}/reminder_templates

Templates de lembrete

Parceiros

Convenios, seguros e planos de saude vinculados aos atendimentos.

/api/v1/accounts/{id}/partners

Listar parceiros

/api/v1/accounts/{id}/partners

Criar parceiro

/api/v1/accounts/{id}/partners/{partner_id}

Atualizar parceiro