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.

[Agendar demonstração](https://nuvia.ai/demo?cta=api_hero_demo) [Ver a documentação](https://developers.nuvia.ai/)

*[Terminal da API da Nuvia com rotas de agentes, contatos, conversas, mensagens, campanhas, base de conhecimento e webhooks, e uma chamada em que o CRM inscreve um contato numa campanha.]*

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. Tudo numa plataforma com relatório SOC 2 Type II emitido.

### 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.

*[Casos de uso]*

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

Resultado**Lead 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

[Ler o guia de webhooks](https://developers.nuvia.ai/guias/webhooks)

*[Eventos da Nuvia chegando por webhook no sistema da empresa, cada um respondido com 200. A etapa da conversa muda para Proposta e o sistema responde enviando o link da proposta pela API.]*

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.

1**Conecte com segurança** Gere no painel uma chave com só os acessos de que a integração precisa.

2.

2**Traga a sua operação** Contatos, listas e campanhas entram pela API, direto do seu CRM, ERP ou planilha.POST /v1/contacts

3.

3**Reaja a cada conversa** O seu sistema fica sabendo de cada evento na hora e responde pela API, sem ninguém no meio.POST /v1/webhooks

[Abrir o guia de início rápido](https://developers.nuvia.ai/quickstart) [Como gerenciar as chaves de API](https://nuvia.ai/docs/artigos/15230128-como-gerenciar-api-keys-na-nuvia)

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](https://nuvia.ai/docs/colecoes/19724087-mcp-da-nuvia)

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](https://nuvia.ai/features/funil-inteligente/agent-builder)

Dúvidas

## Perguntas frequentes

**Qual a diferença entre API, webhook e MCP?**

A API é para o seu sistema chamar a Nuvia com uma chave; o webhook é a Nuvia avisando o seu sistema quando algo acontece; e o MCP é para assistentes de IA, como Claude e ChatGPT, operarem a Nuvia em linguagem natural com o login da plataforma.

**Onde está a documentação da API?**

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á.

**O que a API da Nuvia cobre?**

Agentes, contatos, conversas, mensagens, campanhas e base de conhecimento, além de [busca e enriquecimento de dados](https://nuvia.ai/features/dados-e-enriquecimento). Cada chave tem só os escopos que você escolher.

**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 do [WhatsApp pela API oficial](https://nuvia.ai/features/canais).

**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](https://nuvia.ai/features/campanhas) 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 da API?**

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.

**A Nuvia é SOC 2?**

Sim. A Nuvia está em conformidade com o SOC 2 Type II, com relatório emitido em novembro de 2026 após auditoria independente da Advantage Partners. O relatório e os controles de segurança estão no Trust Center, em trust.nuvia.ai.

**O que é MCP e para que serve?**

O MCP é um padrão aberto que conecta assistentes de IA a outros sistemas. Com o MCP da Nuvia, o Claude, o ChatGPT ou um agente próprio entram com o login da Nuvia e consultam e operam conversas, contatos e campanhas em linguagem natural, e é por ele que o [Agent Builder](https://nuvia.ai/features/funil-inteligente/agent-builder) monta agentes.

## Leve a Nuvia para dentro dos seus sistemas

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

[Agendar demonstração](https://nuvia.ai/demo?cta=api_final_demo) [Ver a documentação](https://developers.nuvia.ai/)

---
Source: https://nuvia.ai/features/api-mcp-webhooks
