API, MCP e Webhooks

Construa o que a sua operação
precisa sobre a Nuvia

Uma API aberta para integrar seus sistemas e criar features, webhooks para escutar
cada evento e MCP para construir direto do Claude ou do ChatGPT.

Por que a Nuvia

A plataforma se adapta à operação, não o contrário

Toda operação tem regras e sistemas próprios. Quando a ferramenta só integra pelo que vem pronto, é o processo que se encaixa nela. Na Nuvia, o seu time estende a plataforma.

Em plataformas fechadas

  • Integração só com o que já vem pronto no catálogo
  • API parcial, que não faz o que o time faz na tela
  • Poucos eventos para avisar os seus sistemas
  • Dados presos, exportados à mão em planilha
  • Cada regra nova vira um pedido no roadmap do fornecedor

Com a Nuvia

  • API pública para agentes, contatos, conversas, mensagens, campanhas e tabelas
  • Webhooks que avisam os seus sistemas a cada mensagem, conversa e contato
  • O agente chama o seu sistema no meio da conversa
  • MCP para operar e construir pelo Claude, ChatGPT ou um agente próprio
  • Chaves de API por escopo, uma para cada integração
Para os seus sistemas

Três formas de construir sobre a Nuvia

Integre pela API, escute pelos webhooks e deixe o agente chamar o seu sistema no meio da conversa. Cada integração com a sua chave e só os escopos de que precisa.

API pública e completa

Mais de 100 rotas para agentes, contatos, conversas, mensagens, inboxes, campanhas, tabelas e base de conhecimento.

Eventos em tempo real

Os webhooks avisam o seu sistema quando chega uma mensagem, a etapa do funil muda ou um contato é atualizado.

O agente chama o seu sistema

No meio da conversa, o Funil Inteligente faz uma requisição HTTP ao seu sistema e responde ao cliente com o dado real.

Uma chave por integração

Cada chave recebe só os escopos de que precisa, com validade opcional e revogação na hora.

Casos de uso

O que o seu time constrói sobre a Nuvia

Integrações que fazem cada lead ser atendido na hora e cada dado chegar aonde precisa, sem ninguém copiar e colar.

  1. Seu siteO lead converte no formulário de contato
  2. API da NuviaO contato é criado na Nuvia e entra numa sequência de WhatsApp, e-mail e ligaçãoPOST /v1/campaigns/{id}/enrollments/from-contact
  3. Funil InteligenteO agente puxa a conversa em segundos, qualifica e oferece horários
ResultadoLead atendido em segundos, sem ninguém copiar e colar
Webhooks

Escute cada evento e responda pela API

Cadastre a URL do seu sistema, escolha os eventos e ele fica sabendo na hora: mensagem recebida ou lida, conversa criada, etapa do funil alterada, contato atualizado. Com o evento em mãos, o seu sistema responde pela API.

  • Escolha os eventos: mensagens, conversas, contatos, follow-ups e campos
  • Payload em JSON, com os dados no mesmo formato das rotas da API
  • Headers próprios em cada entrega para o seu sistema validar a origem
  • Pause e retome a escuta sem refazer a configuração
Como começar

Sua integração no ar no mesmo dia

O seu time conecta a Nuvia ao CRM, ao ERP e ao que mais a operação usa em três passos.

  1. 1Conecte com segurançaGere no painel uma chave com só os acessos de que a integração precisa.
  2. 2Traga a sua operaçãoContatos, listas e campanhas entram pela API, direto do seu CRM, ERP ou planilha.POST /v1/contacts
  3. 3Reaja a cada conversaO seu sistema fica sabendo de cada evento na hora e responde pela API, sem ninguém no meio.POST /v1/webhooks
Para os seus agentes de IA

Prefere construir com IA? Use o MCP

Conecte o Claude, o ChatGPT ou um agente próprio ao servidor MCP da Nuvia, faça login e opere a plataforma em linguagem natural. Cada ação fica registrada na auditoria.

Opere a Nuvia pela sua IA

Pelo MCP, o Claude, o ChatGPT ou um agente próprio consultam e operam contatos, listas, conversas e campanhas, e pedem confirmação antes de ativar.

Cada ação da IA registrada

A Auditoria MCP mostra o que cada assistente consultou ou alterou, quem pediu e quando.

Como conectar o MCP

Agent Builder

Crie e melhore o seu Funil Inteligente conversando com a IA que você já usa

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
Conhecer o Agent Builder
Dúvidas

Perguntas frequentes

Onde está a documentação?

Em developers.nuvia.ai, com a referência completa da API e dos webhooks, guias e exemplos de integração, em português, inglês e espanhol. A especificação OpenAPI e a coleção do Postman também estão lá.

Quais eventos posso receber por webhook?

Mensagem recebida, enviada, entregue, lida e com falha; conversa criada, atualizada e com etapa alterada; contato criado e atualizado; follow-up enviado e campo atualizado. Você escolhe quais quer receber.

Consigo enviar templates de WhatsApp em massa pela API?

Sim. A API envia mensagens de texto, imagem, áudio, vídeo e documento, e também templates aprovados pela Meta em massa, inclusive fora da janela de 24 horas.

Consigo inscrever um contato numa campanha a partir do meu CRM?

Sim. Quando um lead novo entra ou um negócio muda de etapa no seu CRM, ele inscreve o contato numa campanha ativa pela API. A Nuvia cria o contato se ele ainda não existir e avisa o seu sistema pelos webhooks.

Como funciona a autenticação?

Cada integração usa uma chave de API criada por um administrador em Configurações › API Keys e enviada no header Authorization. A chave tem só os escopos escolhidos, validade opcional e pode ser revogada a qualquer momento.

Qual a diferença entre a API e o MCP?

A API é para sistemas: o seu código chama a Nuvia com uma chave. O MCP é para assistentes de IA: o Claude, o ChatGPT ou um agente próprio se conectam com o login da Nuvia e operam a plataforma em linguagem natural.

Leve a Nuvia para dentro dos seus sistemas

Mostramos a API, os webhooks e o MCP funcionando com a sua operação.

Falar com a Nuvia no WhatsApp