Pular para o conteúdo principal

Integrações Externas

Além das ferramentas de CRM nativas, o Tyxter Studio permite conectar seus agentes a sistemas externos. Isso significa que o agente pode executar ações reais fora da plataforma — consultar estoque, criar pedidos, agendar em calendários externos ou interagir com qualquer API.

O que são integrações externas​

Integrações externas conectam o agente a APIs de terceiros ou sistemas próprios. O agente pode:

  • Consultar dados em sistemas externos
  • Criar registros em outras plataformas
  • Executar ações em tempo real durante a conversa
  • Combinar dados externos com ferramentas nativas do CRM

Exemplos de uso​

IntegraçãoO que o agente pode fazer
ShopifyConsultar produtos, verificar estoque, criar pedidos
Google CalendarVerificar disponibilidade, criar eventos, cancelar reuniões
Sistemas internosConsultar status de pedidos, verificar saldo, atualizar cadastros
APIs customizadasQualquer ação que sua API suporte

Como configurar​

Existem dois cenários principais para conectar APIs externas:

API simples (chave + endpoints)​

Para APIs que já estão acessíveis publicamente e usam autenticação por chave:

  1. Insira a chave da API
  2. Configure os endpoints que o agente pode acessar
  3. O agente passa a usar a API automaticamente

Exemplos: Shopify, OpenWeather, APIs REST públicas.

API que exige hospedagem​

Para sistemas internos ou APIs que não estão expostas publicamente:

  1. Utilize um serviço como Cloudflare Workers para criar um intermediário
  2. Gere a URL pública da API
  3. Configure os endpoints no Tyxter
dica

Cloudflare Workers é recomendado para hospedar APIs intermediárias — oferece controle, flexibilidade e é gratuito em muitos casos.

Treinamento automático com integrações​

O treinamento automático não configura apenas o prompt do agente — ele também ajusta como o agente utiliza as integrações externas.

Ao adicionar ferramentas e conectar APIs, o treinamento automático:

  • Testa se o agente aciona as APIs nos momentos corretos
  • Valida se os parâmetros enviados estão corretos
  • Ajusta instruções para melhorar o uso das integrações

Isso significa que você conecta a API, e o treinamento cuida de ensinar o agente a usá-la corretamente.

Quando usar integrações externas​

  • Você já tem sistemas próprios e quer que o agente interaja com eles
  • Precisa de dados em tempo real que não estão no CRM do Tyxter (ex: estoque, preços)
  • Quer executar ações fora da plataforma (ex: criar pedidos, enviar emails)
cuidado

Se você conectar uma API externa que cobre a mesma função de uma ferramenta nativa do CRM (ex: Google Calendar e Agendas), desative a ferramenta nativa para evitar conflitos. Veja mais em Ferramentas CRM.

Documentação para desenvolvedores​

A configuração detalhada de integrações — autenticação, formatos de endpoint, schemas e exemplos de código — está disponível na documentação técnica em tyxter.dev.