​
O que são Integrações

Integrações são a forma de ligar o avatar a outros sistemas, serviços e fontes de dados. Elas permitem que a conversa deixe de ser apenas texto e passe a consultar APIs, acionar automações low‑code e usar plugins universais (MCP) para buscar ou registrar informações em tempo real.

Quando bem configuradas, as integrações:

  • ampliam o que o avatar consegue saber (dados externos, históricos, cálculos complexos);
  • aumentam o que ele consegue fazer (criar registros, atualizar sistemas, disparar fluxos em outras plataformas);
  • alimentam a memória de longo prazo do lead/contato, permitindo que informações retornem em atendimentos futuros.

Pense nas integrações como o pilar que conecta o avatar ao “mundo lá fora”. Ele trabalha em conjunto com Automações, que definem quando e como essas conexões são usadas.

​
Como as integrações funcionam na prática

Na plataforma, as integrações acontecem principalmente a partir da funcionalidade de Automações:

  • você define um gatilho no campo QUANDO;
  • e, no campo ENTÃO, adiciona agentes como Chamar API, MCP ou Buscar na Internet;
  • cada execução de automação pode enviar dados da conversa para fora e trazer respostas que influenciam o fluxo conversacional.

Esses retornos podem:

  • alterar instruções da próxima resposta do avatar;
  • atualizar a memória da conversa atual;
  • ser salvos no registro do lead (contato) para uso em interações futuras.

Sempre que pensar “o avatar precisa consultar outro sistema ou disparar uma ação fora da Tolky”, muito provavelmente você está falando de Integrações via Automações.

​
Integrações via agente “Chamar API”

O agente Chamar API é o caminho principal para integrar a Tolky com APIs HTTP de outros sistemas (internos ou externos).

Com ele, você pode:

  • definir a URL e o método HTTP (GET, POST, PUT, etc.);
  • enviar body JSON, headers e query params baseados em dados da conversa (por exemplo: CPF, e‑mail, número de pedido, intenção detectada);
  • controlar mensagens de erro e instruções de sucesso;
  • decidir se a resposta da API será:
    • inserida diretamente no diálogo,
    • usada apenas como dado de contexto para o modelo,
    • armazenada na memória/cadastro do lead.

O fluxo típico é:

  1. QUANDO determinada condição acontecer (ex.: “usuário pedir segunda via de boleto”);
  2. ENTÃO → agente Chamar API consulta um endpoint externo passando os dados conversacionais;
  3. a resposta da API volta para o avatar, que:
    • usa esses dados para responder com precisão;
    • registra informações para próximas interações (ex.: status do pedido, plano atual, limite disponível).

​
Conectando com n8n, Make e outras plataformas low‑code

Em vez de chamar diretamente todos os sistemas da sua empresa, você pode apontar o agente Chamar API para ferramentas de automação como n8n ou Make.

Isso traz benefícios importantes:

  • desenvolvimento mais rápido: você orquestra integrações complexas em um fluxo visual;
  • camada de abstração: a Tolky fala apenas com um endpoint único (do n8n/Make), que por sua vez chama CRMs, ERPs, gateways de pagamento, etc.;
  • mais robustez: controle de erros, filas, reprocessamentos e logs ficam na ferramenta low‑code, reduzindo complexidade dentro do avatar.

Em resumo: o avatar conversa com uma API única e inteligente, e essa API se encarrega de organizar o resto.

​
Integrações via MCP (plugins universais)

Além das chamadas de API tradicionais, a Tolky também pode usar MCP (Model Context Protocol), um padrão aberto que permite conectar o modelo a uma grande variedade de plugins universais e sistemas externos.

Com MCP, você pode:

  • expor ferramentas padronizadas para o avatar (consultar banco de dados, acessar tickets, ler documentos, etc.);
  • reutilizar integrações em diferentes hosts e aplicações compatíveis com MCP;
  • ter mais flexibilidade para evoluir integrações sem acoplar tudo diretamente em uma única API.

Se quiser se aprofundar:

Assim como o agente de API, as chamadas MCP também são disparadas a partir de Automações, dentro do bloco ENTÃO, combinadas com outros agentes quando fizer sentido.

​
Outros agentes que funcionam como camada de integração

Nem toda integração precisa ser uma API estruturada ou um servidor MCP. Alguns agentes já oferecem uma camada de integração pronta, por exemplo:

  • Buscar na Internet: quando a informação precisa estar sempre atualizada (notícias, cotações, documentação online, mudanças de legislação, etc.);
  • agentes específicos de consulta externa (como busca em bases públicas ou serviços de terceiros);
  • agentes de captura de dados que preparam as informações necessárias para uma chamada de API ou MCP em seguida.

Esses agentes também são configurados dentro de Automações, no bloco ENTÃO, e podem ser combinados com Chamar API e MCP em um mesmo fluxo.

​
Por que integrações são importantes

Sem integrações, o avatar fica limitado ao que está no envelope e na base de conteúdo. Com integrações bem desenhadas, ele passa a:

  • consultar dados vivos (status de pedido, limite de plano, saldo, agendamentos, registros de atendimento);
  • executar ações reais (criar tickets, registrar leads, atualizar cadastros, disparar campanhas, gerar documentos);
  • manter uma visão consistente do cliente entre canais e atendimentos.

Alguns exemplos práticos do que pode ser feito:

  • consultar o status de uma entrega em tempo real e já orientar o usuário sobre o próximo passo;
  • gerar uma segunda via de boleto ou fatura diretamente pela conversa;
  • registrar um lead no CRM (ex.: HubSpot, RD Station) assim que determinados dados forem capturados;
  • atualizar o plano de um cliente em um sistema de billing ao fim de um fluxo de upsell;
  • abrir e atualizar tickets de suporte em ferramentas externas.

Quanto mais o avatar tomar decisões com base em dados externos, mais importante é garantir que as integrações estejam seguras, documentadas e monitoradas.

​
Exemplo completo de fluxo com integrações

Imagine um fluxo de renegociação de pagamento:

  1. QUANDO o usuário disser que está com dificuldade para pagar a fatura atual.
  2. ENTÃO → agente Capturar dados coleta CPF e e‑mail para identificar o cliente.
  3. ENTÃO → agente Chamar API envia esses dados para um fluxo no n8n/Make, que:
    • consulta o sistema financeiro,
    • calcula opções de renegociação,
    • retorna um resumo das possibilidades.
  4. A resposta volta para a Tolky e é usada para:
    • orientar o avatar a explicar cada opção de forma clara,
    • registrar na memória do lead qual opção foi escolhida.
  5. Opcionalmente, outro agente (via MCP ou API) pode:
    • registrar a renegociação em um sistema externo,
    • gerar o novo boleto ou link de pagamento.

Resultado: o usuário resolve a situação sem sair da conversa, enquanto múltiplos sistemas conversam entre si nos bastidores via Automações + Integrações (API, MCP e outros agentes).

Chamar APIBusca na Internet