# 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](https://docs.eloquus.io/ferramentas/contas_listar.md) **Minhas contas.** As contas da Eloquus que este token alcança agora, com o seu papel em cada uma. Ler · Leitura ## Conversas - [conversa_enviar_mensagem](https://docs.eloquus.io/ferramentas/conversa_enviar_mensagem.md) **Mandar mensagem.** Manda uma mensagem de texto ao cliente numa conversa da Eloquus (dentro da janela de atendimento do canal). Enviar · Escrita - [conversa_criar_nota](https://docs.eloquus.io/ferramentas/conversa_criar_nota.md) **Nota interna na conversa.** Cria uma nota interna numa conversa (a equipe vê, o cliente não). Organizar · Escrita - [conversa_transferir](https://docs.eloquus.io/ferramentas/conversa_transferir.md) **Transferir conversa.** Passa a conversa para uma pessoa da equipe (pessoaId), para um time (timeId) ou os dois. Organizar · Escrita - [conversa_etiquetar](https://docs.eloquus.io/ferramentas/conversa_etiquetar.md) **Etiquetar conversa.** Acrescenta e tira etiquetas da conversa, sem mexer nas outras. Organizar · Escrita - [caixas_listar](https://docs.eloquus.io/ferramentas/caixas_listar.md) **Listar caixas.** Lista as caixas de entrada (canais) da conta que você vê, com id, nome e tipo de canal. Ler · Leitura - [etiquetas_listar](https://docs.eloquus.io/ferramentas/etiquetas_listar.md) **Listar etiquetas.** Lista as etiquetas da conta, com nome e cor. Ler · Leitura - [conversas_listar](https://docs.eloquus.io/ferramentas/conversas_listar.md) **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). Ler · Leitura - [conversas_mensagens](https://docs.eloquus.io/ferramentas/conversas_mensagens.md) **Ler mensagens.** As mensagens de uma conversa, as mais recentes, em ordem de leitura (mais antigas primeiro). Ler · Leitura ## Contatos - [contatos_buscar](https://docs.eloquus.io/ferramentas/contatos_buscar.md) **Buscar contatos.** Busca contatos por nome, telefone ou e-mail. Ler · Leitura - [contatos_obter](https://docs.eloquus.io/ferramentas/contatos_obter.md) **Ver contato.** Os dados de um contato pelo id, com os campos personalizados que você pode ver. Ler · Leitura ## Negócios Depende do plano da conta. - [crm_mover_negocio](https://docs.eloquus.io/ferramentas/crm_mover_negocio.md) **Mover negócio de etapa.** Leva o negócio para outra etapa do mesmo funil. Organizar · Escrita · Depende do plano: CRM - [crm_preencher_campos](https://docs.eloquus.io/ferramentas/crm_preencher_campos.md) **Preencher campos do negócio.** Grava valores nos campos personalizados do negócio. Organizar · Escrita · Depende do plano: CRM - [crm_negocios_listar](https://docs.eloquus.io/ferramentas/crm_negocios_listar.md) **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. Ler · Leitura · Depende do plano: CRM - [crm_negocio_obter](https://docs.eloquus.io/ferramentas/crm_negocio_obter.md) **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). Ler · Leitura · Depende do plano: CRM ## Painel Depende do plano da conta. Por padrão, só administradores veem. - [conversas_metricas](https://docs.eloquus.io/ferramentas/conversas_metricas.md) **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). Ler · Leitura · Depende do plano: Painel · Só administradores por padrão ## Atividades Depende do plano da conta. - [atividades_listar](https://docs.eloquus.io/ferramentas/atividades_listar.md) **Listar atividades.** Lista as atividades que você vê, em ordem de prazo (sem prazo por último). Ler · Leitura · Depende do plano: Atividades - [atividades_obter](https://docs.eloquus.io/ferramentas/atividades_obter.md) **Ver atividade.** Uma atividade pelo id, com a versão (para atualizar). Ler · Leitura · Depende do plano: Atividades - [atividades_configuracao](https://docs.eloquus.io/ferramentas/atividades_configuracao.md) **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. Ler · Leitura · Depende do plano: Atividades - [atividades_criar](https://docs.eloquus.io/ferramentas/atividades_criar.md) **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. Organizar · Escrita · Depende do plano: Atividades - [atividades_atualizar](https://docs.eloquus.io/ferramentas/atividades_atualizar.md) **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. Organizar · Escrita · Depende do plano: Atividades - [atividades_mudar_status](https://docs.eloquus.io/ferramentas/atividades_mudar_status.md) **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. Organizar · Escrita · Depende do plano: Atividades - [atividades_reagendar](https://docs.eloquus.io/ferramentas/atividades_reagendar.md) **Reagendar atividade.** Troca o prazo e o lembrete de uma atividade, sobre a versão atual. Organizar · Escrita · Depende do plano: Atividades ## Para automatizar O catálogo completo, com os esquemas de entrada e saída, está em [catalogo.json](https://docs.eloquus.io/catalogo.json). Os limites estão em [Limites e segurança](https://docs.eloquus.io/limites-e-seguranca.md#limites).