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