🔧API🔧
      Voltar para o início
      1. Central de Ajuda
      2. Conhecendo a Tess AI
      3. 🔧API🔧

      🎥Automatize Fluxos de Trabalho com a API da Tess AI🗒️

      Aprenda como usar a API da Tess de maneira aprimorada!

      Integrando a API da Tess AI em seus Fluxos de Trabalho

      Este artigo explica como usar a API da Tess AI para integrar inteligência artificial em seus fluxos de trabalho externos, automatizando tarefas e enriquecendo dados.

      Princípios da API

      A API permite que aplicações externas acessem as funcionalidades da Tess AI, como execução de agentes, processamento de linguagem natural e outras tarefas de IA. Isso possibilita a integração da IA em seus próprios sistemas, aproveitando o treinamento e os prompts configurados na plataforma Tess AI.

      Exemplo de Uso (Transcrição e Geração de Atas)

      Um administrador de escola pode automatizar a geração de atas de reuniões. Ele grava a reunião, salva o vídeo no Google Drive, e a API da Tess AI é acionada. O áudio é transcrito usando serviços como Deep Grun, AssemblyAI, Have.ai ou Whisper da OpenAI. A transcrição é então processada por um agente na Tess AI, treinado para gerar a ata formatada.

      Novidades da API

      A Tess AI está em constante desenvolvimento, e novas funcionalidades são adicionadas regularmente. Fique atento às novidades na documentação da API.

      Acessando a API

      Existem duas maneiras principais de acessar a API:

      1. AI Studio (Automations): Crie automações que disparam webhooks para seus agentes/templates.
      2. API Tokens: Gere um token de acesso na seção "API Tokens" do seu perfil e utilize-o para autenticar suas requisições. A documentação completa da API está disponível no menu superior da plataforma.

      • Caso Prático: Classificação de Feedbacks: Automação para classificar feedbacks de clientes (sentimento, categoria, motivo) com base em novas entradas em uma planilha.

      • Integração com Zapier (passo a passo)

        1. Autenticação: Autentique-se no Zapier com seu token da API da Tess AI.
        2. Novo Zap: Crie um novo Zap.
        3. Gatilho: Escolha o gatilho "Nova Linha na Planilha" (Google Sheets).
        4. Selecionar Planilha: Selecione a planilha e a aba que contém os feedbacks.
        5. Ação: Executar Template: Adicione a ação "Executar Template" (Tess AI App).
        6. Selecionar Template: Escolha o template de classificação de feedbacks.
        7. Mapear Campos: Mapeie os campos "feedback" e "estrelas" da planilha para os parâmetros correspondentes do template.
        8. Webhook Callback URL (para segundo Zap): Configure o "Webhook Callback URL" para um segundo Zap que irá processar a resposta.
        9. Segundo Zap - Gatilho: Crie um segundo Zap com o gatilho "Catch Hook".
        10. Copiar URL do Webhook: Copie a URL do webhook gerada no segundo Zap e cole no campo "Webhook Callback URL" do primeiro Zap.
        11. Segundo Zap - Mapear Campos: No segundo Zap, mapeie os campos da resposta da Tess AI ("sentimento", "categoria", "motivo") para as colunas correspondentes na planilha.
        12. Segundo Zap - Ação: Atualizar Linha: Adicione a ação "Atualizar Linha na Planilha" (Google Sheets).
        13. Mapear ID da Linha: Mapeie o ID da linha para garantir que o registro correto seja atualizado.
        14. Alternativa (Delay): Como alternativa ao segundo Zap, use a ação "Delay" no primeiro Zap para aguardar a resposta da Tess AI. Isso simplifica o fluxo, mas pode ser menos eficiente para processamentos demorados.

      • Integração com Make (passo a passo)

        1. Novo Cenário: Crie um novo cenário no Make.
        2. Gatilho: Adicione o gatilho "Assistir mudanças na planilha" (Google Sheets).
        3. Selecionar Planilha: Selecione a planilha e a aba que contém os feedbacks.
        4. Módulo HTTP (POST): Adicione o módulo "HTTP" e configure o método para POST.
        5. URL de Execução: Configure a URL de execução do template (consulte a documentação da API da Tess AI).
        6. Cabeçalho Authorization: Adicione o cabeçalho "Authorization" com o valor "Bearer <seu_token>".
        7. Corpo da Requisição: No corpo da requisição, informe os parâmetros ("feedback", "estrelas") no formato JSON ou "multipart/form-data".
        8. Armazenar ID da Execução: Adicione um módulo "Set Variable" para armazenar o ID da execução retornado pela API.
        9. Módulo Repeater (Polling): Adicione um módulo "Repeater" para implementar o polling.
        10. Intervalo de Polling: Configure o intervalo de tempo entre as verificações de status.
        11. Módulo HTTP (GET) dentro do Repeater: Dentro do repeater, adicione um módulo "HTTP" com o método GET.
        12. URL de Verificação de Status: Configure a URL de verificação de status (da documentação da API), incluindo o ID da execução armazenado anteriormente.
        13. Cabeçalho Authorization (GET): Adicione o cabeçalho "Authorization" com o valor "Bearer <seu_token>".
        14. Condição de Parada do Repeater: Configure o repeater para parar quando o campo "status" da resposta for "success" ou "fail".
        15. Extrair Dados da Resposta: Após o repeater, adicione um módulo "Set Variable" para extrair os dados da resposta ("sentimento", "categoria", "motivo").
        16. Atualizar Planilha: Adicione o módulo "Atualizar uma linha" (Google Sheets).
        17. Mapear Dados para Planilha: Mapeie as variáveis contendo os dados extraídos para as colunas correspondentes na planilha.

      • Créditos da API: O uso da API consome créditos, mesmo com o plano ilimitado da plataforma. O consumo é informado nas respostas das automações.

      Descubra tudo isso na Tess AI!