API do Crisp: o que dá para fazer e como usar com agentes de IA
A API REST do Crisp permite ler e enviar mensagens, gerenciar conversas, contatos e operadores e trabalhar com a base de ajuda, além de receber eventos por webhook. É usada por empresas que atendem pelo chat do site e canais ligados ao Crisp. O acesso é por plugin registrado no marketplace do Crisp, com token e escopos aprovados.
Os grandes recursos da API, em português claro.
Lista, estado, atribuição e metadados das conversas.
Leitura e envio de mensagens em nome do site.
Perfis de pessoas com dados e segmentos.
Equipe de atendimento e disponibilidade.
Artigos do centro de ajuda.
Eventos de mensagem recebida e outros, por webhook ou em tempo real.
Como se acessa a API do Crisp.
- Com credencial da sua empresaToken de plugin (identificador e chave) obtido no marketplace de desenvolvedores do Crisp, com escopos aprovados e instalado no site do cliente.
- Documentação oficialdocs.crisp.chat
- Escopos de plugin passam por aprovação; peça o mínimo.
- Conversas contêm dados pessoais (LGPD).
- Respeite os limites de requisição da API.
- api crisp
- crisp chat api
- crisp api webhook
- crisp plugin token
- integração api crisp
- crisp api documentação
O que um agente do iTeam faz com a API do Crisp.
O agente responde no chat do site com base nos artigos de ajuda e passa para um operador quando o assunto pede.
Quando o visitante pergunta sobre planos, o agente qualifica, registra no contato e chama o vendedor.
O agente avisa a equipe sobre conversas abertas sem resposta acima do prazo.
Perguntas frequentes sem artigo viram rascunhos para a equipe publicar.
Da credencial ao agente trabalhando, com aprovação.
Crie o plugin e solicite os escopos
No marketplace do Crisp, registre o plugin e peça só os escopos necessários.
Instale no site e cadastre no cofre
O token fica no cofre do iTeam e o agente responde só nas caixas liberadas.
Teste com aprovação
Comece com respostas sugeridas ao operador antes de responder sozinho.
Dúvidas sobre a API do Crisp.
A API do Crisp é gratuita?
Depende do uso: há recursos de API e plugin com limites e planos; confirme as condições atuais no Crisp.
Preciso programar para usar a API do Crisp com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam lê a documentação e o time de implantação configura os fluxos.
O agente pode passar a conversa para um humano?
Sim, o agente atribui a conversa a um operador e deixa o resumo.
Como obter o token de plugin da API do Crisp?
Registre um plugin no marketplace de desenvolvedores do Crisp, que gera o identificador e a chave. Peça os escopos necessários e instale o plugin no site do cliente. Os escopos passam por aprovação, então peça só o mínimo e descreva o uso.
Por que o Crisp exige aprovação de escopos do plugin?
Porque o plugin acessa conversas de atendimento, que contêm dados de clientes. A aprovação dos escopos faz parte do modelo do marketplace, e quem pede menos acesso costuma ser mais rápido de liberar. Detalhes no docs.crisp.chat.
O agente de IA responde conversas do Crisp automaticamente?
Pode ler a conversa, preparar a resposta e enviar a mensagem pela API, recebendo novas mensagens por webhook ou pelo RTM. O desenho mais seguro é o agente responder o que sabe e passar para um operador quando o assunto exigir decisão.
Como o agente passa a conversa do Crisp para uma pessoa?
Pelo recurso de conversas e operadores da API, o agente atribui a conversa a um operador ou grupo. Ele deixa uma nota interna com o resumo do caso. Assim o atendente humano não pergunta tudo de novo ao cliente.
O que são webhooks e RTM no Crisp?
Webhooks entregam eventos, como mensagem nova, para um endereço seu. O RTM é uma conexão em tempo real que o agente mantém aberta para receber eventos. Para um agente que precisa responder rápido, qualquer dos dois evita ficar consultando a API.
A base de ajuda do Crisp pode alimentar o agente?
Sim, a API trabalha com a base de ajuda. O agente consulta os artigos publicados para responder dúvidas com a mesma informação que o cliente leria. Mantenha os artigos atualizados, porque o agente repetirá o que estiver escrito.
Conversas do Crisp têm dados pessoais? Como fica a LGPD?
Sim, nomes, e-mails e histórico de atendimento são dados pessoais. Defina o que o agente lê e guarda, por quanto tempo, e informe o cliente que parte do atendimento é automatizado, conforme a política de privacidade.
O Crisp limita o número de chamadas à API?
Há limites de requisição que o agente deve respeitar, tratando o erro de excesso com espera. Prefira receber eventos por webhook em vez de consultar conversas em laço, o que reduz as chamadas. Detalhes do limite atual estão em docs.crisp.chat.
