Referência de ferramentas
As 23 ferramentas que o conector oferece hoje, por área da Eloquus. Esta lista é gerada do próprio app: quando uma ferramenta entra ou muda, a página muda junto.
O que cada selo quer dizer
- Ler conversas, mensagens, métricas, contatos, negócios e atividades. Escopo
eloquus:ler. - Organizar criar nota interna, transferir, etiquetar, mover ou preencher negócios e criar, atualizar ou reagendar atividades. Escopo
eloquus:organizar. - Enviar mensagens para os seus clientes. Escopo
eloquus:enviar.
Toda ferramenta, menos contas_listar, pede o parâmetro conta, com o nome da conta (o slug). Toda escrita aceita pedidoId, um uuid seu: repita o mesmo para não duplicar uma ação quando a resposta não chegou.
Por que uma ferramenta pode não aparecer para você
- A conta não tem o recurso do plano que a ferramenta usa (CRM, Painel, Atividades).
- O seu papel na conta não alcança aquela área. O Painel, por exemplo, é só de administradores, a menos que o administrador libere para você. O administrador também pode liberar ou bloquear áreas por pessoa.
- Você não marcou Organizar ou Enviar quando conectou. Para ganhar, desconecte e conecte de novo, marcando o que faltou.
- O conector não está ligado na conta, ou o administrador deixou a conexão só para administradores.
Contas
- contas_listar
Minhas contas. As contas da Eloquus que este token alcança agora, com o seu papel em cada uma.
LerLeitura
Conversas
- conversa_enviar_mensagem
Mandar mensagem. Manda uma mensagem de texto ao cliente numa conversa da Eloquus (dentro da janela de atendimento do canal).
EnviarEscrita - conversa_criar_nota
Nota interna na conversa. Cria uma nota interna numa conversa (a equipe vê, o cliente não).
OrganizarEscrita - conversa_transferir
Transferir conversa. Passa a conversa para uma pessoa da equipe (pessoaId), para um time (timeId) ou os dois.
OrganizarEscrita - conversa_etiquetar
Etiquetar conversa. Acrescenta e tira etiquetas da conversa, sem mexer nas outras.
OrganizarEscrita - caixas_listar
Listar caixas. Lista as caixas de entrada (canais) da conta que você vê, com id, nome e tipo de canal.
LerLeitura - etiquetas_listar
Listar etiquetas. Lista as etiquetas da conta, com nome e cor.
LerLeitura - conversas_listar
Listar conversas. Lista as conversas que você vê, filtradas pela data em que a conversa começou (dias inteiros em America/Sao_Paulo), por caixa, situação e etiqueta, em ordem de início (o número da conversa).
LerLeitura - conversas_mensagens
Ler mensagens. As mensagens de uma conversa, as mais recentes, em ordem de leitura (mais antigas primeiro).
LerLeitura
Contatos
- contatos_buscar
Buscar contatos. Busca contatos por nome, telefone ou e-mail.
LerLeitura - contatos_obter
Ver contato. Os dados de um contato pelo id, com os campos personalizados que você pode ver.
LerLeitura
Negócios
Depende do plano da conta.
- crm_mover_negocio
Mover negócio de etapa. Leva o negócio para outra etapa do mesmo funil.
OrganizarEscritaDepende do plano: CRM - crm_preencher_campos
Preencher campos do negócio. Grava valores nos campos personalizados do negócio.
OrganizarEscritaDepende do plano: CRM - crm_negocios_listar
Listar negócios. Lista os negócios de um funil do CRM (o padrão, sem
LerLeituraDepende do plano: CRMfunil): os abertos e os fechados nos últimos 90 dias, com etapa, valor em centavos e contato, em ordem de criação. - crm_negocio_obter
Ver negócio. Os dados de um negócio do CRM pelo id, com funil, etapa, valor em centavos, contato e campos personalizados (pelo nome).
LerLeituraDepende do plano: CRM
Painel
Depende do plano da conta. Por padrão, só administradores veem.
- conversas_metricas
Métricas de atendimento. Conversas abertas e resolvidas, tempo médio da primeira resposta e da resolução (em segundos), por dia e por caixa, no período (America/Sao_Paulo).
LerLeituraDepende do plano: PainelSó administradores por padrão
Atividades
Depende do plano da conta.
- atividades_listar
Listar atividades. Lista as atividades que você vê, em ordem de prazo (sem prazo por último).
LerLeituraDepende do plano: Atividades - atividades_obter
Ver atividade. Uma atividade pelo id, com a versão (para atualizar).
LerLeituraDepende do plano: Atividades - atividades_configuracao
Tipos e status das atividades. Os tipos e os status ativos da conta (com a categoria de cada status), os agentes que podem ser responsáveis e o fuso da conta: os nomes que as outras ferramentas aceitam.
LerLeituraDepende do plano: Atividades - atividades_criar
Criar atividade. Cria uma atividade (tarefa, ligação, reunião, retorno, prazo) com prazo, lembrete, responsável, setor e vínculos com contato, conversa e negócio.
OrganizarEscritaDepende do plano: Atividades - atividades_atualizar
Atualizar atividade. Altera os campos que vierem, na versão lida (atividades_obter): se alguém mudou a atividade antes, recusa e pede para ler de novo.
OrganizarEscritaDepende do plano: Atividades - atividades_mudar_status
Mudar status da atividade. Leva a atividade para um status (pelo id, pelo nome ou pela categoria: concluida conclui, cancelada cancela, a_fazer reabre), com o resultado opcional.
OrganizarEscritaDepende do plano: Atividades - atividades_reagendar
Reagendar atividade. Troca o prazo e o lembrete de uma atividade, sobre a versão atual.
OrganizarEscritaDepende do plano: Atividades
Para automatizar
O catálogo completo, com os esquemas de entrada e saída, está em catalogo.json. Os limites estão em Limites e segurança.