🔒 Cadastrar: administradores. Usar: administradores e agentes com a permissão Visualizar aplicativos no tipo de agente.
Um App da Dashboard abre uma página do seu sistema (ERP, CRM, painel de pedidos, base de conhecimento interna) dentro da plataforma. Na conversa, o app recebe quem é o cliente e qual é a conversa, e pode mostrar na hora os pedidos, o cadastro ou o histórico daquela pessoa — sem o agente trocar de janela.
Cadastrar um app
Vá em Configurações → Integrações → Apps da Dashboard e clique em Adicionar um novo app da dashboard.
- Nome — o que aparece na aba ou no menu.
-
Endpoint — a URL
https://da página do seu sistema. -
Mostrar app na lateral — onde o app aparece:
- desmarcado: como uma aba dentro de cada conversa, ao lado de Mensagens, recebendo o cliente e a conversa abertos;
- marcado: como um item da seção Aplicativos do menu lateral, em tela cheia, recebendo só o usuário e a conta.
Como o agente usa
Na conversa, a aba com o nome do app abre a página do seu sistema já posicionada no cliente atendido:
Pelo menu lateral, o app abre em tela cheia, sem conversa — bom para consultas gerais.
O que o seu sistema precisa fazer
A página é carregada em um quadro dentro da plataforma e recebe, por mensagem do navegador, um JSON com o agente (nome, e-mail), a conta, e — na aba da conversa — a conversa e o contato (nome, telefone, e-mail, atributos). Com isso ela busca os dados certos.
- A página precisa permitir ser exibida dentro de outro site (sem bloqueio de frame) e estar em
https://. - Os dados chegam no navegador e não são assinados: use-os para saber quem está acessando e confirme a permissão no seu servidor, consultando a API da plataforma com o token de acesso, antes de liberar informações sensíveis.
- Ocultar o app por permissão só esconde o botão; quem decide o acesso é o seu sistema.
O guia técnico com o formato das mensagens e exemplos de código está disponível com o suporte.
Apps da Dashboard ou webhooks?
- App da Dashboard — o agente vê o seu sistema dentro da plataforma.
- Webhooks — o seu sistema recebe os eventos da plataforma (nova mensagem, conversa resolvida) para agir sozinho.
Os dois se complementam: o webhook cria o cliente no CRM, e o app mostra a ficha dele na conversa.