Pular para o conteúdo
Eloquuspara desenvolvedoresEntrar

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

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 funil): os abertos e os fechados nos últimos 90 dias, com etapa, valor em centavos e contato, em ordem de criação.

    LerLeituraDepende do plano: CRM
  • 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.