Como usar aplicativos no painel da Akece (Dashboard Apps)
Os aplicativos de painel permitem que você integre uma aplicação personalizada diretamente na interface da Akece. Essa
funcionalidade é ideal para exibir informações como pedidos, histórico de pagamentos ou dados do cliente diretamente ao
lado da conversa, facilitando o trabalho da equipe de atendimento.
Sua aplicação será carregada dentro da interface da Akece e receberá o contexto da conversa e do contato
automaticamente, via eventos do navegador.
Como criar um aplicativo de painel
1. Acesse Configurações → Integrações → Aplicativos de painel.
2. Clique no botão Configurar correspondente à opção de Aplicativos de painel.
3. Preencha os campos:
- Nome do aplicativo: um nome interno para identificação.
- URL do aplicativo: o link onde sua aplicação está hospedada.
Após salvar, uma nova aba com o nome definido será exibida no painel lateral da conversa. Ao acessá-la, a aplicação será
carregada dentro da Akece, já com os dados do contato e da conversa disponíveis.
Como receber os dados da Akece no seu app
A Akece envia o contexto da conversa e do contato como um evento de window. Basta implementar um listener na sua
aplicação para capturar os dados:
window.addEventListener("message", function (event) {
if (!isJSONValid(event.data)) return;
const eventData = JSON.parse(event.data);
// Utilize eventData conforme necessário
});
Como solicitar os dados sob demanda
Se quiser requisitar o contexto manualmente (on-demand), envie a seguinte mensagem para a janela pai:
window.parent.postMessage('akece-dashboard-app:fetch-info', '*');
A Akece irá responder com o contexto da conversa, contato e atendente, no formato abaixo:
Exemplo de payload retornado
{
"event": "appContext",
"data": {
"conversation": {
// Dados da conversa, incluindo mensagens, status, etiquetas, atributos personalizados, etc.
},
"contact": {
// Dados do contato, como nome, e-mail, telefone, atributos personalizados, etc.
},
"currentAgent": {
// Dados do atendente logado
}
}
}
Campos disponíveis no payload
conversation:
- ID da conversa, status, etiquetas, data/hora
- Lista de mensagens com remetente, conteúdo, tipo
- Atributos do navegador e origem
- Informações do atendente e do canal
contact:
- Nome, e-mail, telefone, atributos personalizados
- Informações de redes sociais (se fornecidas)
- Última atividade
currentAgent:
- Nome, e-mail e ID do atendente atualmente logado
Com isso, seu aplicativo estará integrado ao painel da Akece, com acesso em tempo real ao contexto da conversa. É uma
forma poderosa de estender funcionalidades, como visualizar o histórico de pedidos de um cliente, dados de assinatura,
pagamentos anteriores e muito mais — sem sair da conversa.
Se tiver dúvidas ou precisar de ajuda para configurar sua aplicação, entre em contato com nosso suporte:
📩 [email protected] | 📱 @akece.ai
