Introdução

Como integrar seu sistema à Nupapia

A API de integração da Nupapia permite que o seu sistema acesse, de forma segura, dois pedaços da conta de um cliente Nupapia:

• Conversas — ler e enviar mensagens de chat, iniciar conversa de WhatsApp com um contato novo, consultar status e mudar o estágio de uma conversa no funil.
• CRM — ler e criar clientes, gerenciar tags e campos personalizados.

Nenhum outro dado da conta (faturamento, outros usuários, configurações internas) fica acessível por esta API — mesmo que seu token pertença a um administrador da conta.

Pra saber de mensagens novas sem ficar consultando a API, veja Webhooks — alternativa ao polling.

Esta é uma API para o seu backend conversar com a Nupapia (servidor para servidor). Ela não deve ser chamada diretamente do navegador do usuário final — o token de integração dá acesso a dados de clientes e não deve ficar exposto em código de frontend.

Como começar

1. Gere um token de integração

   Dentro da Nupapia, vá em Configurações → Integrações e clique em Gerar novo token. Escolha o acesso que seu sistema precisa (Chat, CRM, ou ambos) e dê um nome que identifique o sistema que vai usar esse token.

   O valor do token só é mostrado uma vez — copie e guarde num lugar seguro assim que ele for gerado.

2. Autentique suas chamadas

   Veja Autenticação para o formato exato do cabeçalho.

3. Explore a referência da API

   A aba Referência da API lista todos os endpoints disponíveis, com exemplos de requisição e resposta.