# Nupapia

## Docs

- [Introdução](https://docs.nupapia.com.br/introduction.md): Como integrar seu sistema à Nupapia
- [Autenticação](https://docs.nupapia.com.br/autenticacao.md): Como usar o token de integração nas chamadas
- [Webhooks](https://docs.nupapia.com.br/webhooks.md): Receba mensagens em tempo real, sem precisar de polling
- [Listar conversas](https://docs.nupapia.com.br/api-reference/conversas/listar-conversas.md)
- [Contagem de conversas por status](https://docs.nupapia.com.br/api-reference/conversas/contagem-de-conversas-por-status.md)
- [Detalhar uma conversa](https://docs.nupapia.com.br/api-reference/conversas/detalhar-uma-conversa.md)
- [Atualizar uma conversa](https://docs.nupapia.com.br/api-reference/conversas/atualizar-uma-conversa.md): Atualização genérica — envie apenas os campos que quer alterar (status, estágio do pipeline, responsável, etc).
- [Atualizar status da conversa](https://docs.nupapia.com.br/api-reference/conversas/atualizar-status-da-conversa.md)
- [Atualizar estágio de pipeline da conversa](https://docs.nupapia.com.br/api-reference/conversas/atualizar-estágio-de-pipeline-da-conversa.md)
- [Listar mensagens de uma conversa](https://docs.nupapia.com.br/api-reference/conversas/listar-mensagens-de-uma-conversa.md): Paginação por cursor — use `before_id` para buscar mensagens mais antigas.
- [Enviar mensagem](https://docs.nupapia.com.br/api-reference/conversas/enviar-mensagem.md)
- [Iniciar conversa com um contato novo](https://docs.nupapia.com.br/api-reference/conversas/iniciar-conversa-com-um-contato-novo.md): Único jeito de falar com alguém que nunca conversou com a empresa — acha ou cria o cliente pelo telefone, cria (ou reaproveita, se já houver uma aberta) a conversa, e envia a primeira mensagem.
- [Listar templates de WhatsApp](https://docs.nupapia.com.br/api-reference/conversas/listar-templates-de-whatsapp.md): Use `status=APPROVED` pra listar só os prontos pra enviar.
- [Enviar template numa conversa já existente](https://docs.nupapia.com.br/api-reference/conversas/enviar-template-numa-conversa-já-existente.md)
- [Listar canais da empresa](https://docs.nupapia.com.br/api-reference/conversas/listar-canais-da-empresa.md): Use pra descobrir o `channel_id` de um canal de WhatsApp antes de chamar start-whatsapp.
- [Listar clientes](https://docs.nupapia.com.br/api-reference/clientes/listar-clientes.md)
- [Criar cliente](https://docs.nupapia.com.br/api-reference/clientes/criar-cliente.md): Informe pelo menos um de `email` ou `phone` — não é preciso os dois. Útil pra importar bases onde nem todo contato tem e-mail cadastrado.
- [Detalhar cliente](https://docs.nupapia.com.br/api-reference/clientes/detalhar-cliente.md): Inclui tags, endereços e aliases de contato.
- [Atualizar cliente](https://docs.nupapia.com.br/api-reference/clientes/atualizar-cliente.md)
- [Listar tags do cliente](https://docs.nupapia.com.br/api-reference/clientes/listar-tags-do-cliente.md)
- [Adicionar tag ao cliente](https://docs.nupapia.com.br/api-reference/clientes/adicionar-tag-ao-cliente.md)
- [Listar tags da empresa](https://docs.nupapia.com.br/api-reference/crm-—-tags/listar-tags-da-empresa.md)
- [Criar tag](https://docs.nupapia.com.br/api-reference/crm-—-tags/criar-tag.md)
- [Atualizar tag](https://docs.nupapia.com.br/api-reference/crm-—-tags/atualizar-tag.md): Endpoint de atualização usa `POST`, não `PUT`.
- [Remover tag](https://docs.nupapia.com.br/api-reference/crm-—-tags/remover-tag.md)
- [Listar campos personalizados](https://docs.nupapia.com.br/api-reference/crm-—-campos-personalizados/listar-campos-personalizados.md)
- [Criar campo personalizado](https://docs.nupapia.com.br/api-reference/crm-—-campos-personalizados/criar-campo-personalizado.md)
- [Atualizar campo personalizado](https://docs.nupapia.com.br/api-reference/crm-—-campos-personalizados/atualizar-campo-personalizado.md): Endpoint de atualização usa `POST`, não `PUT`.
- [Remover campo personalizado](https://docs.nupapia.com.br/api-reference/crm-—-campos-personalizados/remover-campo-personalizado.md)
- [Ler valores de campos personalizados de uma entidade](https://docs.nupapia.com.br/api-reference/crm-—-campos-personalizados/ler-valores-de-campos-personalizados-de-uma-entidade.md)
- [Gravar valores de campos personalizados de uma entidade](https://docs.nupapia.com.br/api-reference/crm-—-campos-personalizados/gravar-valores-de-campos-personalizados-de-uma-entidade.md)

## OpenAPI Specs

- [openapi](https://docs.nupapia.com.br/api-reference/openapi.yaml)