Use este artigo para configurar os modelos de Data connector do Pendo, para que Fin possa ver o que um cliente estava fazendo no seu produto antes de pedir ajuda. Também cobre o que os clientes veem, as limitações e como corrigir problemas comuns de configuração. Este artigo é para colegas que configuram Data connectors para Fin. Você também precisará de acesso ao Agent Toolkit do Pendo.
O que são os modelos de Data connector do Pendo?
Os modelos de Data connector do Pendo são 5 Data connectors prontos que conectam Fin ao Agent Toolkit do Pendo. O Pendo registra como os clientes usam seu produto, incluindo as páginas que visitam, os recursos que usam e onde encontram erros ou dificuldades. Com os modelos de Data connector do Pendo, Fin pode usar esse contexto para personalizar suas respostas e pular etapas que o cliente já tentou.
Por que usar os modelos de Data connector do Pendo?
Os modelos de Data connector do Pendo ajudam Fin a responder perguntas sobre o produto sem pedir que o cliente explique o que fez:
Comece com contexto: Fin vê a atividade recente da sessão do cliente, então o cliente não precisa descrever o que estava fazendo.
Indique o guia correto: Fin encontra o guia in-app do Pendo que corresponde a uma pergunta de como fazer e compartilha um link que o inicia.
Capture feedback do produto: Fin pode enviar feedback para o Pendo em nome do cliente.
Pule a construção: Os campos de solicitação, entradas e resposta já estão configurados, então você não precisa construí-los manualmente.
Quais modelos de Data connector do Pendo estão disponíveis?
Esta tabela lista os 5 modelos de Data connector do Pendo no grupo de modelos "Pendo Agent Toolkit API" e o que Fin obtém de cada um.
Modelo | O que Fin obtém |
Obter atividade da sessão Pendo para um visitante | Um resumo e linha do tempo do que o visitante estava fazendo recentemente, incluindo páginas, itens, configurações, erros e dificuldades como cliques mortos. Fin passa uma descrição curta da pergunta do cliente, para que o resumo foque no que importa. |
Encontrar um guia in-app do Pendo | O guia do Pendo que melhor corresponde a uma pergunta de como fazer, com um link que inicia o guia no seu app. Fin compartilha o link com o cliente. |
Obter atividade do agente AI do Pendo para um visitante | As 3 conversas mais recentes do visitante com seus agentes AI no produto dos últimos 30 dias, e os 3 problemas mais recentes detectados, como erros e alucinações. Requer Pendo Agent Analytics. |
Listar áreas do produto Pendo | Todas as áreas do produto na sua assinatura Pendo, com seu ID e descrição. Fin usa isso antes de enviar feedback. |
Enviar feedback para o Pendo para um visitante | Cria um item de feedback no Pendo Feedback para o visitante, com título, descrição, área do produto opcional e um link para a conversa no Intercom. Requer Pendo Feedback. |
Exemplos de perguntas de clientes que os modelos de Data connector do Pendo ajudam Fin a responder incluem:
Continuo recebendo um erro quando tento salvar minhas configurações.
Como crio um novo painel?
Seu assistente in-app me deu a resposta errada.
Você pode passar uma solicitação de recurso para sua equipe de produto?
Dica: Combine os modelos de Data connector do Pendo com Procedimentos Proativos para iniciar uma conversa com Fin quando o Pendo detectar sinais de frustração. Saiba como acionar um procedimento proativo a partir de uma API externa.
O que você precisa antes de configurar os modelos de Data connector do Pendo?
Antes de configurar os modelos de Data connector do Pendo, certifique-se de que você tem:
Acesso ao Pendo Agent Toolkit: Permissão no Pendo para criar um agente e uma conta de serviço.
Autenticação do cliente: Código de uso único (OTP) por e-mail ou segurança Messenger com JSON Web Tokens (JWT) configurados no Intercom. Data connectors não podem funcionar sem isso. Saiba mais sobre configurar autenticação para Data connectors.
Correspondência de IDs de visitante: O ID de visitante Pendo de cada cliente disponível no Intercom, seja como o ID do usuário Intercom ou no atributo pendoVisitorId.
Add-ons do Pendo para 2 modelos: Pendo Agent Analytics para atividade do agente AI, e Pendo Feedback para envio de feedback.
Nota: Os modelos de Data connector do Pendo suportam apenas apps web e cobrem apenas clientes logados com um ID de visitante Pendo. Apps móveis e extensões de navegador ainda não são suportados.
Como configurar os modelos de Data connector do Pendo
Cada modelo de Data connector do Pendo cria seu próprio Data connector. Crie a conta de serviço Pendo uma vez, depois repita os passos no Intercom para cada modelo que você quer que Fin use.
Como criar uma conta de serviço Pendo para Fin
Para criar a conta de serviço Pendo que os modelos de Data connector do Pendo usam:
No Pendo, crie um agente Intercom Fin no Agent Toolkit.
Crie uma conta de serviço para o agente.
Copie a URL do token, client ID, client secret e scope. Você vai colar esses dados no Intercom quando adicionar seu token de autenticação Pendo.
Como criar um Data connector Pendo a partir de um modelo
Para criar um Data connector Pendo a partir de um modelo no Intercom:
Vá para Configurações > Integrações > Data connectors e clique em Novo.
Em Ou comece a partir de um modelo, escolha Pendo Agent Toolkit API.
Escolha um modelo, leia o que ele faz e clique em Criar.
Um rascunho do conector de Dados Pendo abre com os campos de solicitação, entradas e resposta já preenchidos.
Como adicionar seu token de autenticação Pendo
Para adicionar seu token de autenticação Pendo a um conector de Dados Pendo:
Em Authentication tokens, clique em New token e escolha o tipo OAuth (Open Authorization).
Cole a URL do token, client ID, client secret e scope que você copiou do Pendo.
Selecione o token no conector de Dados.
Dica: Quando configurar seu próximo modelo de conector de Dados Pendo, selecione o mesmo token de autenticação Pendo em vez de criar um novo.
Como definir as entradas de dados do Pendo
Para definir as entradas de dados para um conector de Dados Pendo:
Em Data inputs, marque pendo_host. O padrão é
app.pendo.io. Se sua assinatura Pendo estiver hospedada na região EU, AU, Japão ou us1, altere seu Custom value para o host Pendo da sua região.Mapeie a entrada Visitor ID para o atributo Intercom que contém o ID do visitante Pendo do cliente. Se seu User ID do Intercom e o ID do visitante Pendo coincidirem, use User ID. Se não coincidirem, sincronize os IDs e use o atributo pendoVisitorId.
Se o modelo solicitar configurações de equipe, como seu app ID Pendo, agent ID ou hostname do link do guia, insira-os como Custom values.
Nota: Fin nunca preenche configurações de equipe para os modelos de conector de Dados Pendo, como seu app ID Pendo, agent ID ou hostname do link do guia. Apenas colegas definem esses valores.
Como testar um conector de Dados Pendo e ativá-lo
Para testar um conector de Dados Pendo e permitir que Fin o use:
Teste o conector de Dados com o ID do visitante de um cliente de teste que tenha atividade recente no Pendo.
Na aba Fin, em How should Fin use this connector?, escolha Enabled (direct trigger).
Clique em Set live.
Uma vez que o conector de Dados Pendo esteja ativo, Fin o aciona automaticamente quando a pergunta do cliente corresponder ao que o modelo faz.
Nota: Você só pode testar completamente os modelos de conector de Dados Pendo em um workspace de produção, não em um workspace de teste.
Nota: Cada chamada bem-sucedida para Submit Pendo feedback for a visitor cria um novo item de feedback no Pendo, então use um cliente de teste ao testar este modelo.
O que os clientes veem quando Fin usa os modelos de conector de Dados Pendo?
Os clientes não veem o Pendo quando Fin usa os modelos de conector de Dados Pendo, porque Fin usa o contexto do Pendo nos bastidores. A única diferença visível é o link do guia: quando Fin encontra um guia Pendo correspondente, ele responde com um link que inicia o walkthrough no seu app.
Conversas onde Fin usa dados do Pendo aparecem na Inbox como qualquer outra conversa do Fin.
Como gerar relatórios dos modelos de conector de Dados Pendo
Os modelos de conector de Dados Pendo não têm um relatório dedicado. Eles são conectores de Dados padrão, então seu uso aparece nos seus relatórios existentes de conector de Dados e Fin.
Quais são as limitações dos modelos de conector de Dados Pendo?
Os modelos de conector de Dados Pendo têm estas limitações, com soluções alternativas quando existem:
Apenas apps web: Apps móveis e extensões de navegador ainda não são suportados, e não há solução alternativa.
Apenas clientes logados: Fin só pode buscar clientes que estejam logados e tenham um ID de visitante Pendo.
Correspondência de Visitor ID: Se o Visitor ID no Intercom não corresponder ao Pendo, Fin não consegue encontrar o cliente. Sincronize os IDs e mapeie a entrada Visitor ID para o atributo pendoVisitorId.
Apenas atividade marcada: Resumos de sessão incluem apenas páginas e recursos marcados no Pendo. Marque mais páginas e recursos no Pendo para incluí-los.
Autenticação do cliente necessária: Os modelos não podem ser ativados até que o email OTP ou a segurança do Messenger estejam configurados.
Apenas testes em produção: Você só pode testar completamente os modelos em um workspace de produção, não em um workspace de teste.
Add-ons do Pendo: A atividade do agente AI precisa do Pendo Agent Analytics, e o envio de feedback precisa do Pendo Feedback. Sem eles, esses 2 modelos não retornam dados úteis.
Novo item de feedback por chamada: Cada chamada bem-sucedida para Submit Pendo feedback for a visitor cria um novo item de feedback no Pendo.
Sem contato proativo: Os modelos não iniciam conversas. Para que Fin entre em contato quando o Pendo detectar frustração, configure sinais de frustração no Pendo e combine-os com Procedimentos Proativos, que precisam do Proactive Support Plus ou Full Suite.
FAQs dos modelos de conector de Dados Pendo
Por que Fin não consegue encontrar meu cliente no Pendo?
Fin não consegue encontrar um cliente no Pendo quando o Visitor ID no Intercom não corresponde ao Pendo, ou quando o cliente não tem atividade marcada. Verifique se a entrada Visitor ID está mapeada para o atributo correto. Se seus User IDs do Intercom e Visitor IDs do Pendo forem diferentes, sincronize os IDs e use o atributo pendoVisitorId.
Por que Fin encontra alguns clientes no Pendo, mas não outros?
Fin encontra apenas alguns clientes no Pendo quando seus User IDs do Intercom e Visitor IDs do Pendo diferem para os demais. Sincronize os IDs e verifique se o atributo pendoVisitorId está preenchido para esses clientes.
Por que meu conector de Dados Pendo mostra um erro de autenticação?
Um conector de Dados Pendo mostra erro de autenticação quando os valores OAuth estão errados ou expirados, ou quando a conta de serviço foi criada para uma região Pendo diferente. Recrie a conta de serviço no Pendo e crie um novo token OAuth no Intercom com os novos valores.
Por que meu conector de Dados Pendo não retorna dados?
Um conector de Dados Pendo não retorna dados quando pendo_host não corresponde à sua região Pendo. Se ainda estiver definido como app.pendo.io e sua assinatura Pendo estiver hospedada na EU, AU ou Japão, altere para o host Pendo da sua região.
Por que Fin não está usando meu conector de Dados Pendo?
Fin não usa um conector de Dados Pendo a menos que ele esteja ativo e configurado como Enabled (direct trigger) na aba Fin. Abra o conector de Dados, verifique ambas as configurações e clique em Set live se necessário.
Por que o modelo de atividade do agente AI do Pendo não retorna nada?
O modelo Get Pendo AI agent activity for a visitor não retorna nada útil quando sua assinatura Pendo não inclui o Pendo Agent Analytics. Adicione o Agent Analytics no Pendo para usar este modelo.
Por que existem itens de feedback duplicados no Pendo?
Itens de feedback duplicados aparecem no Pendo porque cada chamada bem-sucedida para Submit Pendo feedback para um visitante cria um novo item. Verifique a conversa para tentativas repetidas.
Operator e Copilot podem usar dados do Pendo?
Operator e Copilot podem usar dados do Pendo via Model Context Protocol (MCP), sem os templates do conector Pendo Data. Saiba como conectar o Pendo ao Operator com Connections. Connections estão incluídos no Operator com o add-on Pro. O acesso ao Pendo no Copilot está em beta fechado.