Voltar ao Painel

Documentação

Aprenda a usar o Asyntai

Integração com Activepieces

Use o seu assistente Asyntai dentro dos fluxos do Activepieces

Obter Chave da API

Plano Pago Necessário: A integração com Activepieces funciona nos planos Starter, Standard e Pro. Ver preços

Visão Geral

Activepieces é uma ferramenta de automação de código aberto. A peça Asyntai envia uma mensagem do cliente ao seu assistente e devolve a resposta. Depois você encaminha essa resposta para qualquer ponto do fluxo: uma resposta por e-mail, uma mensagem no Slack, um ticket de suporte ou uma linha de banco de dados.

Ações disponíveis

A peça Asyntai oferece duas ações:

  • Perguntar ao assistente - Envia uma mensagem do cliente a um assistente e devolve a resposta
  • Chamada de API personalizada - Chama qualquer endpoint da API Asyntai com a mesma conexão

Nota: A peça é instalada a partir do npm. Você precisa de uma instância Activepieces auto-hospedada, ou de direitos de administrador de plataforma no Activepieces Cloud.

Como Instalar

Siga estes passos para ligar o Asyntai ao Activepieces:

1

Obtenha sua Chave de API

Abra a página de configurações da API e gere uma chave:

https://asyntai.com/settings/api/

Copie a chave e guarde-a em segurança. Qualquer pessoa com a chave pode aceder à sua conta Asyntai através da API.

2

Instalar a peça Asyntai

No Activepieces, vá a Settings, depois My Pieces, depois Install Piece. Escreva este nome de pacote:

@asyntai/piece-asyntai
3

Conecte a sua conta

Adicione um passo Asyntai a um fluxo. Crie uma nova conexão e cole a sua chave de API. O Activepieces verifica a chave de imediato e mostra um erro se estiver errada.

4

Construir o fluxo

Um fluxo tem duas partes:

  • Gatilho: qualquer gatilho do Activepieces, como um novo e-mail, uma entrada de formulário ou um webhook
  • Ação: Asyntai - Perguntar ao assistente

Ligue a mensagem do cliente e um ID de conversa estável do gatilho à ação Asyntai.

5

Devolver a resposta

Adicione mais um passo para entregar a resposta: Gmail, Slack, um serviço de suporte ou um serviço de SMS. Use o campo answer do passo Asyntai como texto da resposta.

6

Testar e publicar

Faça um teste com uma pergunta real de um cliente. Verifique a resposta e depois publique o fluxo.

Entradas de Perguntar ao assistente

  • Assistant Website (obrigatório) - o assistente que responde. A lista é carregada da sua conta.
  • Customer Message (obrigatório) - o texto que o assistente deve responder.
  • Conversation ID (obrigatório) - um valor estável para este cliente ou tópico, como um endereço de e-mail ou um número de ticket.
  • Source Channel (obrigatório) - de onde veio a mensagem. Os canais de e-mail acrescentam instruções de e-mail ao assistente.

Saídas de Perguntar ao assistente

  • answer - a resposta do assistente.
  • conversation_id - o tópico a que a resposta pertence.
  • ai_disclosure - o texto de aviso de IA. Mostre-o ao cliente.
  • success - se a chamada funcionou.

Dica: Melhore as respostas acrescentando instruções, perguntas frequentes e conteúdo da base de conhecimento no seu painel Asyntai.

Histórico de Conversas

O Asyntai guarda o histórico sob o ID de conversa que você envia. Use o mesmo valor para o mesmo cliente e o assistente recorda as mensagens anteriores. Use um valor novo para abrir um tópico novo.

Cada chamada acrescenta uma mensagem ao histórico, por isso uma execução repetida cria uma entrada duplicada. Tenha isso em conta ao configurar novas tentativas.

Exemplos de Casos de Uso

  • Suporte por e-mail: chega um novo e-mail, o assistente escreve a resposta e o Gmail envia-a
  • Suporte no Slack: uma pergunta num canal do Slack recebe a resposta no mesmo tópico
  • Resposta de formulário: uma entrada do formulário de contacto gera uma resposta por e-mail em segundos
  • Triagem de tickets: o assistente responde aos tickets simples e deixa o resto a uma pessoa
  • Respostas por SMS: ligue um serviço de mensagens e responda aos clientes no telemóvel

Código-fonte

A peça é de código aberto sob a licença MIT. O nome do pacote no npm é:

@asyntai/piece-asyntai

Precisa de Ajuda?

Se tiver uma dúvida ou um problema, escreva-nos para [email protected].