Integrando o Typeform com o Document360 usando Make

Typeform é uma plataforma para criar formulários interativos, pesquisas e quizzes em formato conversacional. Quando clientes ou potenciais clientes enviam respostas por meio dos seus formulários Typeform, essas informações frequentemente contêm conteúdo valioso — perguntas, feedback ou dados — que pertencem à sua base de conhecimento. Ao conectar Typeform e Document360 através do Make, você pode automatizar isso: sempre que uma nova resposta é enviada para um formulário Typeform, Make cria automaticamente um artigo correspondente no Document360, transformando as submissões em documentação sem esforço manual.

Quando usar essa integração

• Você usa o Typeform para coletar perguntas frequentes de clientes ou potenciais clientes e quer que cada submissão gere automaticamente um rascunho de artigo no Document360 para que sua equipe possa transformar as respostas em documentação publicada.
• Você executa pesquisas de feedback pelo Typeform e quer respostas que revelam lacunas de conhecimento para que fluam diretamente para o fluxo de trabalho da sua base de conhecimento para acompanhamento.
• Você quer construir um pipeline de documentação onde as submissões de formulários — filtradas por campos específicos ou status de conclusão — impulsionem a criação de novos artigos no Document360 em um cronograma regular.

Antes de começar

• Você deve ter uma conta ativa de Make.
• Você precisa ter uma conta Typeform com o formulário que deseja usar como gatilho.
• Você deve ter seu token da API do Document360 pronto. Para gerar um, navegue até Conexões > Extensões, localize o bloco Criar e clique em Conectar para copiar o token.

Como configurar o cenário

Passo 1 — Faça login e crie um novo cenário

1. Faça login na sua conta Create. O painel Make aparece.

2. Clique em Criar um novo cenário no canto superior direito.
3. Clique no ícone adicionar (+) — uma lista de aplicações disponíveis aparece.
4. No campo de Busca, digite Typeform.
5. Selecione Typeform e escolha o gatilho que você quer usar. Por exemplo, selecione Assistir Respostas para acionar o Cenário quando uma nova resposta for enviada.

Passo 2 — Configurar o módulo Typeform

Conecte sua conta Typeform e configure as configurações do gatilho.

1. Clique em criar uma conexão e insira um nome da Conexão.
2. Clique em Salvar.
3. Clique em Aceitar para permitir que o Typeform acesse sua conta Criar conta. Sua conta Typeform agora está conectada ao Make.
4. No campo Limite , insira o número máximo de respostas Make retornará por ciclo de execução.
5. Clique no menu suspenso ID do Formulário e selecione o formulário que deseja assistir.
6. Se você quiser que o Cenário seja acionado apenas quando campos específicos estiverem preenchidos, adicione os campos desejados usando Adicionar item na seção de Campos .
7. Na seção Completado , selecione a opção apropriada:
   • Sim — assista apenas aos formulários que já foram totalmente enviados.
   • Não — assista apenas aos formulários que não foram enviados.
   • Vazio — apenas forme-se com respostas vazias.
8. No campo Consulta , insira uma string de texto para observar apenas respostas que contenham esse texto.
9. Clique em OK.
10. No popup Escolher onde começar , selecione a data e o horário a partir dos quais deseja começar a observar novas respostas.
11. Clique em OK.

Passo 3 — Conectar o Document360 como a ação

Uma vez que o Typeform esteja conectado, adicione o Document360 como o próximo módulo no Cenário.

1. Na página do editor de cenários, clique na opção Adicionar outro módulo (+).
2. No campo de Busca, digite Document360.
3. Selecione Document360 e escolha a ação que deseja realizar. Por exemplo, selecione Criar um artigo para criar um rascunho de artigo.
4. No painel Document360, selecione uma conexão existente. Para criar uma nova conexão:
   • Clique em criar uma conexão e insira um nome da Conexão.
   • Digite seu token API do Document360 e clique em Salvar.

Para gerar o token API a partir do Document360:

5. Navegue até Conexões > Extensões na barra de navegação esquerda do portal da Base de Conhecimento.
6. No bloco Criar extensão, clique em Conectar.

7. Clique no ícone Copiar para copiar o token.

8. Volte ao painel Make e cole o token API no campo.
9. No campo Título do Artigo , selecione os parâmetros Typeform que você deseja usar como título do artigo. Por exemplo, selecione o parâmetro Nome da Tarefa .
10. No campo Conteúdo do Artigo , selecione os parâmetros que deseja como conteúdo do artigo. Por exemplo, selecione Nome do Destinatário, Tipo de Recurso e Vencimento Em.
11. No menu suspenso ID da Categoria do Projeto , selecione a categoria onde o novo artigo deve ser criado.
12. Clique em OK.

Passo 4 — Teste o Cenário

1. Clique no botão Correr uma vez no canto inferior esquerdo para testar o cenário. Os detalhes do teste aparecem no final da página.
2. Para acionar o teste, envie uma nova resposta ao formulário Typeform associado.
3. Uma vez que a resposta é enviada, um novo artigo é criado na categoria associada Document360. Você pode verificar isso no painel de detalhes do teste ou navegando diretamente para seu projeto Document360.

Passo 5 — Agende o Cenário

1. Ative a opção de alternância no canto inferior esquerdo para agendar o Cenário. Por padrão, isso executa o Cenário a cada 15 minutos.
2. Clique em OK para salvar.

Passo 6 — Ative o Cenário

1. Clique no ícone Sair da edição () no topo. O painel de integração aparece.
2. Ative a opção LIGAR/DESLIGAR perto da opção Editar para ativar o Cenário.

Uma vez ativado, o Cenário roda automaticamente a cada 15 minutos e cria artigos a partir de novas respostas do Typeform.

Melhores práticas

• Use o filtro Concluído para garantir que o Cenário seja acionado apenas em respostas totalmente enviadas. Definir isso como Sim impede que entradas parciais ou abandonadas gerem artigos incompletos no Document360.
• Use o campo Consulta para restringir quais respostas acionam o Cenário — por exemplo, apenas respostas que mencionam um produto ou tema específico. Isso mantém seu conteúdo do Document360 focado e evita a criação de artigos a partir de submissões irrelevantes.
• Mapee um campo específico de pergunta do Typeform ao Título do Artigo em vez de depender de um parâmetro genérico. Uma pergunta como "Qual é a sua principal dúvida?" gera uma semente de título de artigo mais útil do que um ID de resposta ou um carimbo de tempo de envio.