Apps e integrações

O marketplace de apps fica em Configurações → Apps. Os apps são instalados uma única vez, para o workspace inteiro: um administrador conecta o serviço com as credenciais do próprio workspace, e todo colega de time com acesso à caixa de entrada vê o cartão resultante no painel de conversa. Os atendentes nunca instalam nada por conta própria — e os agentes de IA também não instalam nada.

Seis apps estão disponíveis hoje:

Procurando um link simples para o seu próprio back-office? Isso não exige conta nem token, então fica em Configurações → Geral → Links para seus sistemas, e não no catálogo de apps.

Abra Configurações → Apps, escolha um cartão e preencha as credenciais que o app pede. Cada campo tem um link para a página exata no dashboard do fornecedor onde o valor é criado ou encontrado.

Cada cartão de app carrega um chip de status que diz em que pé está a instalação:

As credenciais dos apps pertencem ao workspace, e algumas regras as mantêm seguras:

• Criptografadas em repouso. Campos secretos (chaves de API, tokens) são criptografados por chave no armazenamento e nunca são exibidos de volta depois de salvos.
• Privilégio mínimo onde o fornecedor permite. O Stripe deve ser conectado com uma chave restrita que possa ler Customers, Subscriptions, Charges e Invoices — mais acesso de escrita a Refunds apenas se os atendentes devem reembolsar a partir de uma conversa. Se você colar uma chave de acesso total ela ainda funciona, mas a página de configurações vai recomendar substituí-la.
• Mudar o destino pede o segredo de novo. Editar um campo ao qual a credencial está vinculada — o domínio da loja Shopify, a URL do site Jira — exige digitar o token novamente, para que uma credencial salva nunca possa ser redirecionada a um host para o qual não foi criada.
• Revogar afeta o workspace inteiro. Há uma instalação por app por workspace: se você rotacionar ou revogar a chave no fornecedor, o cartão de todos os colegas de time para de funcionar até que um administrador o atualize em Configurações → Apps.

Depois de instalado, cada app aparece como um widget no painel de detalhes da conversa na caixa de entrada. Abrir uma conversa busca um cartão ao vivo no fornecedor: quem é esse cliente no Stripe, seus pedidos recentes na Shopify, o status dele na newsletter, as issues do Jira vinculadas à thread, ou o veredito do Tracio sobre o visitante. A maioria dos cartões também leva ao registro correspondente no dashboard do próprio fornecedor — o veredito do Tracio vive inteiramente no painel.

Os cartões são honestos quando não há nada a mostrar. Se o cliente não for encontrado — ou a conversa não tiver identidade utilizável — o cartão diz isso e explica o porquê, em vez de renderizar uma caixa vazia. As respostas são cacheadas por pouco tempo e têm orçamento de requisições por app, para que uma caixa de entrada aberta não consuma os limites de API do fornecedor.

Os cartões seguem a identidade verificada#

Stripe, Shopify, Mailchimp e MailerLite procuram o cliente pelo endereço de e-mail — e apenas por um endereço de fato verificado: um coberto pela identidade assinada do widget (verificação de identidade), ou o endereço From de uma conversa do canal de e-mail. Um endereço que o visitante apenas digitou no chat não é usado para buscas de forma alguma — caso contrário, qualquer um poderia digitar o e-mail de um cliente real e ver seu histórico de pagamentos. Nesse caso, o cartão explica que o endereço não é respaldado por uma identidade verificada.

Jira e Tracio não se baseiam em e-mail — os cartões do Jira pertencem às issues vinculadas à conversa, e o Tracio ao visitante do widget — então funcionam mesmo quando não existe endereço verificado.

Stripe#

Uma janela somente leitura para o faturamento do cliente: nome, e-mail, saldo da conta e um ID de cliente copiável, mais a assinatura — badge de status, plano, valor mensal e data de início — e pagamentos recentes com números de fatura. Reembolsos são a única escrita opcional: um administrador precisa ligar Permitir reembolsos pelo painel de conversa nas configurações do app (desligado por padrão), o operador precisa da permissão Executar reembolsos e cancelamentos, e todo reembolso deve ser confirmado digitando REFUND — o Stripe não consegue desfazer um reembolso depois de enviado.

Shopify#

Pedidos recentes somente leitura — número do pedido, data, total, status de pagamento e de entrega — com links para cada pedido e para o registro do cliente no seu admin da Shopify. Conectado com o domínio da sua loja e um token Admin API de um app personalizado com os escopos read_customers e read_orders.

Mailchimp#

O inscrito como o Mailchimp o vê: badge de status, público, tags, engajamento e atividade recente de campanhas (envios, aberturas, cliques). Uma ação está disponível: Cancelar inscrição, para honrar um pedido de "parem de me mandar e-mail" sem sair da conversa. Ela é irreversível pela API — o Mailchimp só permite que a própria pessoa volte a se inscrever por um formulário de cadastro — então exige uma confirmação digitada. Note que as chaves de API do Mailchimp não têm escopo: a chave que você conecta pode ler e escrever tudo na conta.

MailerLite#

Status de inscrição, grupos, data de cadastro, engajamento e atividade recente de campanhas. Duas ações: Cancelar inscrição (reversível — a API do MailerLite permite reinscrever) e Reinscrever, para recolocar alguém na lista a pedido da própria pessoa.

Jira#

Um vínculo de mão dupla entre conversas e issues do Jira Cloud. O cartão lista as issues vinculadas a esta conversa com seu status atual e oferece Criar issue (aberta no projeto escolhido, vinculada automaticamente) e Vincular existente / Desvincular para issues que já existem. Mudanças de status feitas no Jira voltam por um webhook: a página de configurações do app mostra um endereço de webhook secreto para colar no seu site Jira, e o cartão espelha o status ao vivo da issue dali em diante. As issues são criadas como a conta Atlassian que você conecta, e o cartão vê exatamente o que essa conta vê.

O Tracio responde a uma pergunta sobre o visitante do widget de chat: isto é um humano ou um bot? Instalar o app ativa o SDK de detecção do Tracio dentro do seu widget de chat do Respondo — novas conversas do widget recebem um veredito automaticamente, exibido como um chip no cartão do Tracio no painel de conversa.

Duas chaves são conectadas: uma chave pública que ativa o SDK no widget e uma chave secreta da Data API usada para a verificação server-side do veredito. Sem a verificação server-side, a alegação de "não sou bot" do navegador não pode ser confiada por si só — e quando a alegação do navegador diverge do veredito do servidor, o cartão mostra os dois.

• Os cartões do Stripe e da Shopify são somente leitura — a única escrita em todo o app do Stripe é a ação de reembolso, opcional e explicitamente habilitada.
• Apps baseados em e-mail (Stripe, Shopify, Mailchimp, MailerLite) precisam de um endereço de e-mail verificado. Conversas de visitantes anônimos do widget ou de canais sem endereço mostram um cartão honesto de "nada a consultar".
• O suporte a Jira cobre apenas o Jira Cloud.
• O Mailchimp não oferece reinscrição: uma vez cancelada, só a própria pessoa pode voltar por um formulário de cadastro. Use a reinscrição do MailerLite se esse fluxo importa para você.
• Vereditos do Tracio existem apenas para conversas do widget com o SDK carregado — nunca para canais de e-mail ou mensageria.