Consulte atendimentos, contatos, CRM, tarefas e relatórios sem alterar dados do Sacflow
URL do MCP do Sacflow somente para leitura:
https://api.sacflow.io/mcp/read
As ferramentas de leitura permitem que o Claude, ChatGPT e outros assistentes compatíveis com MCP consultem informações da sua conta Sacflow sem alterar os dados do ambiente.
A conexão utiliza o usuário autenticado no Sacflow e respeita as mesmas permissões de acesso configuradas para ele.
Com essa conexão, o assistente pode:
A conexão de leitura não cria, edita, transfere, resolve ou exclui informações do Sacflow.
Você pode conversar normalmente com o assistente. Não é necessário informar o nome técnico de cada ferramenta.
Por exemplo:
Use o Sacflow e mostre meus atendimentos atualizados hoje.
Procure o contato John Doe e mostre seus últimos atendimentos.
Mostre os cards em andamento no funil Comercial.
Analise o desempenho dos agentes de IA nos últimos 30 dias.
Quando necessário, o assistente consulta primeiro os usuários, departamentos, canais, etiquetas ou funis disponíveis para descobrir os identificadores corretos.
A ferramenta get_current_user identifica qual usuário do Sacflow está conectado ao assistente.
Ela é utilizada em perguntas como:
O assistente não tenta adivinhar quem é o usuário conectado com base nos atendimentos encontrados.
As seguintes ferramentas ajudam o assistente a aplicar filtros corretamente:
Exemplos de perguntas:
Quem está conectado nesta conversa?
Quais departamentos e canais eu posso consultar?
Liste os atendentes ativos da minha conta.
A ferramenta list_tickets consulta atendimentos utilizando filtros combináveis, como:
A consulta sempre respeita os departamentos, canais e permissões do usuário conectado.
Exemplos:
Mostre meus atendimentos em aberto.
Quais atendimentos foram atualizados ontem no departamento Financeiro?
Liste os atendimentos encerrados esta semana pelo atendente João.
Mostre os atendimentos da empresa Acme.
A ferramenta get_ticket apresenta a visão completa de um atendimento, incluindo:
Exemplo:
Mostre os detalhes do atendimento 12345.
A ferramenta list_messages lista as mensagens e os registros internos de um atendimento.
Também é possível solicitar apenas as mensagens da conversa, sem os logs operacionais.
Exemplos:
Mostre as mensagens do atendimento 12345.
Mostre somente a conversa com o cliente no atendimento 12345, sem os logs.
A ferramenta search_messages pesquisa termos no conteúdo das mensagens dos atendimentos que o usuário pode acessar.
Ela pode ser utilizada para descobrir em qual atendimento determinado assunto foi discutido.
Exemplos:
Procure conversas que mencionam reembolso.
Em quais atendimentos o cliente falou sobre cancelamento nos últimos 30 dias?
Procure mensagens sobre segunda via de boleto enviadas pelo cliente.
A ferramenta get_attachment retorna o link para download de um anexo encontrado em uma mensagem, junto com o tipo e o nome do arquivo.
Exemplo:
Abra as mensagens do atendimento 12345 e me mostre os anexos disponíveis.
As ferramentas disponíveis são:
A visão completa pode incluir:
Exemplos:
Procure o contato John Doe.
Mostre os contatos da empresa Acme.
Mostre a visão completa do contato Maria Souza.
Quais foram os últimos atendimentos do contato John Doe?
As ferramentas disponíveis são:
A visão da empresa pode incluir:
Exemplos:
Procure a empresa Acme.
Quais contatos estão vinculados à empresa Acme?
Mostre os negócios em andamento, ganhos e perdidos da empresa Acme.
Por segurança, CPF e CNPJ não são disponibilizados pelo MCP.
As ferramentas disponíveis são:
A configuração pode incluir, quando necessário:
Exemplos:
Quais funis do CRM eu posso consultar?
Mostre as etapas e os motivos de perda do funil Comercial.
A ferramenta list_pipe_cards lista os cards ativos de um funil.
É possível filtrar por:
Exemplos:
Mostre os cards em andamento no funil Comercial.
Quais negócios de alta prioridade estão previstos para fechar este mês?
Mostre os cards da empresa Acme no funil Comercial.
A ferramenta list_pipe_history_cards lista negócios ganhos ou perdidos.
Exemplos:
Mostre os negócios ganhos neste mês.
Quais negócios foram perdidos nos últimos 30 dias?
A ferramenta get_pipe_card apresenta:
Exemplo:
Mostre a visão completa do card 456.
A ferramenta list_pipe_card_events apresenta um histórico incremental dos eventos do CRM, como:
Exemplos:
O que mudou nos cards do CRM hoje?
Mostre os negócios marcados como ganhos ou perdidos esta semana.
A ferramenta list_tasks consulta tarefas respeitando as permissões do usuário.
É possível filtrar por:
Exemplos:
Quais tarefas estão atribuídas a mim?
Mostre minhas tarefas atrasadas.
Quais tarefas foram concluídas esta semana?
A ferramenta list_quick_answers lista as respostas rápidas cadastradas, incluindo atalho, mensagem e filtros relacionados.
Exemplo:
Liste as respostas rápidas disponíveis para o departamento Financeiro.
A ferramenta list_special_dates consulta feriados, eventos e mensagens automáticas cadastradas.
Exemplo:
Quais datas especiais estão cadastradas para este mês?
A ferramenta list_redirects consulta as regras de carteirização de um contato ou empresa.
Essas regras determinam o direcionamento automático de novos atendimentos em cada canal.
Exemplo:
Mostre as regras de carteirização do contato John Doe.
Os relatórios respeitam as permissões de visualização do usuário conectado.
A ferramenta get_period_report apresenta:
Exemplo:
Resuma a operação de atendimento dos últimos 30 dias.
A ferramenta get_ticket_ratings_report apresenta:
Exemplo:
Como estão as avaliações dos atendimentos neste mês?
A ferramenta get_ticket_tags_report mostra as etiquetas mais utilizadas e a taxa de atendimentos etiquetados.
Exemplo:
Quais foram os assuntos mais frequentes nos atendimentos deste mês?
A ferramenta get_transfers_report apresenta:
Exemplo:
Analise as transferências entre departamentos nos últimos 30 dias.
As ferramentas disponíveis são:
O relatório pode incluir taxa de cumprimento, violações e desempenho por evento ou período.
Exemplo:
Mostre o cumprimento dos SLAs neste mês.
Antes de consultar os relatórios, a ferramenta list_flows identifica os fluxos e agentes de IA disponíveis.
A ferramenta get_ai_agents_report apresenta indicadores como:
Exemplo:
Analise o desempenho dos agentes de IA nos últimos 30 dias.
A ferramenta get_ai_agents_series apresenta a evolução dos indicadores por hora, dia ou mês.
Exemplo:
Mostre a evolução diária do custo e das vendas dos agentes de IA neste mês.
A ferramenta get_ai_agents_handover_reasons apresenta os motivos pelos quais os agentes de IA transferiram atendimentos para humanos.
Exemplo:
Por quais motivos os agentes de IA mais transferiram atendimentos para humanos?
A ferramenta get_ai_agents_lost_reasons apresenta os motivos de resolução dos agentes de IA quando não houve transferência para humanos.
Exemplo:
Quais foram os principais motivos de resolução dos agentes de IA?
A ferramenta get_outbounds_report apresenta volume, taxa, origem dos envios e desempenho por canal.
Exemplo:
Analise os envios outbound dos últimos 30 dias.
A ferramenta get_contacts_report apresenta volume de contatos, contatos ativos, inativos, com interação e desempenho por canal.
Exemplo:
Como evoluiu a base de contatos neste mês?
A ferramenta get_organizations_report apresenta volume de empresas, empresas ativas, inativas, com interação e desempenho por canal.
Exemplo:
Mostre o relatório de empresas dos últimos 30 dias.
A conexão utiliza OAuth e opera com a identidade do usuário autenticado no Sacflow.
Isso significa que:
O resultado de algumas consultas pode ser paginado. Quando houver mais informações, o assistente pode solicitar automaticamente as páginas seguintes.
A conexão somente leitura não permite:
Para manter a conexão exclusivamente em modo de leitura, utilize sempre:
https://api.sacflow.io/mcp/read
Ao fazer uma solicitação:
1.
2.
3.
4.
5.
Exemplo completo:
Use o Sacflow para analisar meus atendimentos atualizados nos últimos 7 dias. Separe por status e departamento, destaque os assuntos mais frequentes e mostre os cinco atendimentos que precisam de maior atenção.