Conectar outros sistemas: API e assistente

Para quem é:Dono do negócio

Um token da API deixa outro sistema, como o site da loja ou um sistema de gestão, ler e gravar dados do seu negócio no CalendarNow. O assistente de IA conversa sobre os dados do negócio, aqui no painel ou num assistente externo, como o Claude ou o ChatGPT.

Antes de começar

Só o dono e o administrador geram e revogam tokens.
Os tokens e o assistente dependem do plano. Fora do plano, o item aparece com cadeado e o nome do plano que libera.

Passo a passo

Gerar um token da API

Abra Configurações → Integrações → API e chaves e toque em Gerar token.
Em Nome, dê um nome que diga onde o token vai ser usado.
Em Escopos, marque o que o sistema pode fazer em cada parte do negócio: Leitura só consulta, Escrita também cria e altera. Marque só o necessário.
Se o token for temporário, informe em Expiração (dias) por quantos dias ele vale, de 1 a 365. Em branco, ele não expira.
Toque em Gerar token. O token aparece uma única vez: toque em Copiar, entregue a quem vai configurar o outro sistema e feche em Concluído.

A lista mostra cada token com o começo do código, os escopos, a data de criação, a validade e o último uso. Para cortar o acesso, toque na lixeira da linha e confirme em Revogar. O outro sistema para de funcionar na hora.

Ajustar o assistente de IA

Abra Integrações → Assistente IA e MCP.
Ligue Alterações pelo assistente de IA para o assistente poder propor mudanças nos dados. Nada muda sem você confirmar. Desligado, ele só consulta.
Toque em Salvar, no rodapé.

Para usar os dados do negócio num assistente externo, toque em Abrir o assistente, em Assistente externo (MCP). A tela do assistente mostra o endereço para colar no seu provedor de IA.

Problemas comuns

O token sumiu e não consigo ver de novo. Por segurança, ele aparece só na hora em que é gerado. Revogue o antigo e gere outro.

Gerar token está apagado. Falta o nome ou nenhum escopo foi marcado.

O outro sistema parou de funcionar. O token pode ter vencido ou sido revogado. Confira a coluna Expira em e gere um novo token, se precisar.

O item aparece com cadeado. O recurso não faz parte do seu plano. Veja Ver e mudar o plano.