Kentro - Gestão de Atendimento
Abre a operação do Kentro para o fluxo: fila de atendimento, CRM com funil, produtos, tarefas, arquivos e armazenamento permanente.
O Kentro é um sistema de atendimento e gestão comercial: fila de atendimento por WhatsApp, CRM com funil de oportunidades, cadastro de produtos, tarefas da equipe e galeria de arquivos. Este MiniApp abre praticamente toda essa operação para o fluxo do NicoChat.
Com ele dá para o bot abrir e encerrar atendimentos na fila do Kentro, criar e mover oportunidades no funil, consultar produto por código de barras, distribuir tarefas e guardar dados entre execuções — sem que ninguém precise sair do WhatsApp.
Nota
Você precisa de uma instalação do Kentro e da chave de API dela, que fica em Configurações > Geral. A URL de requisição é o endereço do seu Kentro, informado sem a barra no final.
Campo
Obrigatório
Onde encontrar
URL de Requsição
Sim
A URL padrão para acessar o sistema Kentro deve ser informada sem a barra ('/') ao final. Por exemplo: https://usuario.atenderbem.com
Chave de API
Sim
Sua chave de API pode ser obtida em (Configurações > Geral)
As ações estão organizadas nas mesmas pastas que aparecem no construtor. As entradas listadas são as obrigatórias; as saídas viram variáveis para as etapas seguintes.
Ação
O que faz
Entradas obrigatórias
Saídas
Adicionar Empresa
Cria uma nova empresa.
queueId, name
companyId
Deletar Empresa
Remove uma empresa da base.
queueId, idCompany
—
Editar Empresa
Modifica uma empresa existente.
queueId, idCompany, name
companyId
Obter Empresa
Busca uma empresa a partir de seu ID.
queueId, idCompany
—
Ação
O que faz
Entradas obrigatórias
Saídas
Adicionar Contato
Cria um novo contato.
queueId, name, donotdisturb
contactId
Excluir Contato
Remove um contato.
queueId, contactId
—
Editar Contato
Atualiza os dados de um contato existente.
queueId, idContact, name, donotdisturb
—
Obter Contato
Busca um contato a partir de seu ID.
queueId, idContact
contactInfo
Obter Tags de Contato
Busca a lista de etiquetas de contatos.
queueId
tagsSystem
Pesquisar um Contato
Procura um contato na base de dados utilizando um filtro selecionado.
queueId, searchField, searchValue
contactInfo, contactId
Ação
O que faz
Entradas obrigatórias
Saídas
Adicionar Notificação para um Usuário
Adiciona uma notificação ao usuário.
queueId, userId, text, type
—
Gerar Chave de Autenticação do Usuário
Gera uma chave de autenticação para o usuário.
queueId, userId
username, authkey
Obter Detalhes de um Usuário
Busca detalhes de um usuário.
queueId, userId
userInfo
Ação
O que faz
Entradas obrigatórias
Saídas
Cancelar Mensagens Enfileiradas
Retorna os estado de uma mensagem enfileirada para envio.
queueId, enqueuedIds
—
Alterar o Status das Mensagens Enfileiradas
Altera o estado de uma ou mais mensagens enfileiradas para envio.
queueId, enqueuedIds, newStatus
—
Obter o Status das Mensagens Enfileiradas
Retorna os estado de uma mensagem enfileirada para envio.
queueId, enqueuedId
infoEnqueued
Enfileirar Mensagem para Enviar
Insere uma mensagem na fila para envio.
queueId, number, clientId, text, hidden
enqueuedId
Obter Mensagens de um Chat
Retorna as mensagens de um atendimento.
queueId, chatId, includeUserInfo, includeSystemInfo, includeSupervisorAlerts
maxKId, messages
Obter Status de uma Mensagem
Retorna o status/situação da mensagem.
queueId, kId
messageStatus
Enviar Mensagem no Chat
Envia uma mensagem por um atendimento aberto.
queueId, chatId, text, info, hidden
mID, kID
Ação
O que faz
Entradas obrigatórias
Saídas
Alterar Estágio da Oportunidade
Transfere a oportunidade para outra etapa do funil.
queueId, idOpportunity, destStageId
idOpportunity
Criar Oportunidade
Cria uma nova oportunidade no CRM.
queueId, responsableid, title
idOpportunity
Obter Oportunidade
Busca os dados de uma oportunidade.
queueId, idOpportunity
opportunity
Obter Oportunidades do Funil
Busca todas as oportunidades de um funil.
queueId, pipelineId
openOpportunitys
Inserir uma Anotação na Oportunidade
Insere uma nota na oportunidade.
queueId, id, note
—
Marcar Oportunidade como Perdida
Marca uma oportunidade como perdida.
queueId, id
idOpportunity
Excluir Oportunidade
Exclui uma oportunidade.
queueId, idOpportunity
—
Traferir Oportunidade para um Usuário
Transfere a oportunidade para outro responsável.
queueId, idOpportunity, newResponsableId
—
Alterar Oportunidade
Atualiza uma oportunidade.
queueId, idOpportunity, title
idOpportunity
Marcar Oportunidade como Ganha
Marca uma oportunidade como ganha.
queueId, idOpportunity
—
Ação
O que faz
Entradas obrigatórias
Saídas
Verifique se o Usuário Existe
Verifica se um número de telefone está registrado no serviço de mensagens e, caso positivo, fornece seu ID associado no sistema.
queueId, number
clientId, exists
Finalizar um Chat
Finaliza um atendimento em andamento.
queueId, chatId, SendAutoEndMessage
—
Obter Todos os Chats Abertos
Recupera todos os atendimentos em aberto na fila.
queueId
openChats, chats
Obter Detalhes do Chat
Recupera os detalhes de um atendimento da fila.
queueId, chatId
chatDetail
Obter Histórico de Chat do Cliente
Recupera o histórico de atendimentos de um cliente específico.
queueId, clientId
clientChat
Obter Chats Abertos do Cliente
Busca todos os atendimentos abertos para um determinado cliente, em todas as filas ativas.
queueId
openChats, chats
Obter Foto do Perfil do Usuário
Recupera a foto do perfil de um cliente.
queueId, chatId
url
Abrir um Chat
Abre um novo atendimento na fila ou para um usuário especificado.
queueId, number
chatId
Enviar Template Aprovado pelo WhatsApp
Envia um modelo pré aprovado na Cloud API.
queueId, number, templateId, data
—
Ação
O que faz
Entradas obrigatórias
Saídas
Conectar Fila
Conecta a fila do servidor de mensageria.
queueId
—
Obter Etiquetas da Fila
Busca a lista de etiquetas de chat cadastradas no sistema e atribuídas a fila.
queueId
tags
Obter QR Code de Autenticação
Busca o qrcode de autenticação do serviço mensageria, retorna um SVG.
queueId
—
Obter Detalhes da Fila
Busca os detalhes da fila.
queueId
infoQueue
Ação
O que faz
Entradas obrigatórias
Saídas
Adicionar Item ao Armazenamento Permanente
Adiciona um item ao armazenamento permanente. São permitidos até 10000 itens armazenados.
queueId, key, data
—
Obter Dados do Item com Base em sua Chave
Busca um item do armazenamento permanente, com base em sua chave.
queueId, key
data
Exclui um Item do Armazenamento Permanete com Base em sua Chave
Remove um item do armazenamento permanente, com base em sua chave.
queueId, key
—
Ação
O que faz
Entradas obrigatórias
Saídas
Criar Texto Predefinido
Cria uma mensagem pré definida.
queueId, text, title
textId
Excluir Item da Galeria
Apaga o item indicado na galeria.
queueId, galleryId
—
Excluir Texto Predefinido
Exclui uma mensagem pré definida.
queueId, textId
—
Fazer Download do Arquivo
Faz o download ou streaming do arquivo especificado.
queueId, fileId, download
url
Gerar URL de Download
Gera um link para download do arquivo por terceiros. Qualquer pessoa com esse link poderá acessar o arquivo. O link não pode ser revogado.
queueId, fileId
path
Obter Itens da Galeria
Retorne uma lista de itens da galeria.
queueId
itemsGallery
Obter Textos Predefinidos
Retorna lista de itens das mensagens pré definidas.
queueId
texts
Ação
O que faz
Entradas obrigatórias
Saídas
Criar um Produto
Cria um novo produto.
queueId, name, hiddenfromclients, addtoqueues
productId
Obter Produto pelo Código de Barras
Retorna o primeiro produto encontrando com o Código de Barras informado.
queueId, filter
infoProduct
Obter Porduto por ID
Retorna o produto com o ID informado.
queueId, productId
infoProduct
Obter Produto por Código Interno
Retorna o primeiro produto encontrando com o código interno informado.
queueId, filter
infoProduct
Obter Produtos das Filas
Retorna todos os produtos cadastrados na Base.
queueId
allProducts
Exclui um Produto
Exclui um produto.
queueId, idProduct
idProduct
Atualizar um Produto
Atualiza o cadastro de um produto.
queueId, idProduct, name, hiddenfromclients, addtoqueues
productId
Ação
O que faz
Entradas obrigatórias
Saídas
Criar uma Tarefa
Cria uma nova tarefa na base.
queueId, owner, title, action, users
taskId
Obter Tarefa por ID
Busca uma tarefa com base em seu ID.
queueId, taskId
infoTask
Obter Tarefas Pendentes
Busca as tarefas a fazer do grupo de usuários informado.
queueId, usersIds
todoTasks
Marcar Tarefa como CONCLUIDA
Marca uma tarefa como concluída.
queueId, id, userId
taskDoneID
Marcar Tarefa como PENDENTE
Marca uma tarefa como não concluída.
queueId, idTask
notDoneTaskID
Excluir Tarefa
Apaga uma tarefa existente. Essa operação não poderá ser desfeita.
queueId, idTaks
removeTaskID
Atualizar Tarefa
Altera/modifica uma tarefa na base.
queueId, owner, idTask, title, action, users
updatedTaskID
- Praticamente toda ação pede o
queueId, que é a fila do Kentro em que ela vai agir. Guarde esse valor num campo do bot logo no começo do fluxo em vez de repetir a digitação em cada bloco. - A URL de requisição vai sem a barra final. É o endereço da sua instalação do Kentro, não um endereço do NicoChat.
- A pasta Armazenamento é um par chave-valor permanente dentro do Kentro. Serve para guardar estado que precisa sobreviver ao fim da conversa — algo que os campos do contato no NicoChat não cobrem quando o dado é da fila, e não da pessoa.
- Enfileirar Mensagem para Enviar não envia na hora: coloca na fila e devolve um
enqueuedId, que você usa depois para consultar o status ou cancelar o envio. - Em Enviar Template Aprovado pelo WhatsApp, o modelo precisa já estar aprovado na Cloud API — o Kentro só dispara o que a Meta liberou.
- Gerar URL de Download cria um link que qualquer pessoa com o endereço acessa. Trate como link público e evite usá-lo para documento sensível.
- Excluir tarefa, contato, produto ou oportunidade é definitivo — não há desfazer pela API.
- NicoApps (MiniApps) Nativos — a lista completa de integrações prontas