Catálogo de operações MCP

Este endpoint retorna todas as contas cadastradas.

Este endpoint cria uma nova conta com os dados fornecidos no corpo da requisição.

Este endpoint retorna os detalhes de uma conta especificada pelo identificador.

Este endpoint atualiza os dados de uma conta existente identificada pelo id.

Este endpoint deleta uma conta existente identificada pelo id.

Este endpoint retorna todos os contatos cadastrados.

Este endpoint cria um novo contato com os dados fornecidos no corpo da requisição.

Este endpoint retorna todos os contatos vinculados a uma conta específica.

Este endpoint retorna os detalhes de um contato especificado pelo identificador.

Este endpoint atualiza os dados de um contato existente identificado pelo id.

Este endpoint exclui um contato existente identificado pelo id.

This endpoint returns all registered agents.

This endpoint creates an agent.

This endpoint creates a new conversation between a user and the agent.

This endpoint adds a file to the specified agent.

This endpoint removes a file previously attached to the agent.

This endpoint runs the agent with the provided input message.

This endpoint fetches the content of a web page and adds it as knowledge to the agent.

This endpoint removes the old web page content and fetches the updated content, replacing it in the agent's knowledge.

This endpoint returns the details of an agent specified by the identifier.

This endpoint updates the agent.

This endpoint deletes an existing agent identified by id, including removal of the agent from the ElevenLabs service.

This endpoint uploads a logo/icon image for the specified agent.

This endpoint removes the logo/icon image of the specified agent.

Este endpoint cria uma nova variável de coleta de dados de agente com os dados fornecidos.

Este endpoint retorna os detalhes de uma variável de coleta de dados de agente especificada pelo identificador.

Este endpoint atualiza os dados de uma variável de coleta de dados de agente existente identificada pelo id.

Este endpoint remove uma variável de coleta de dados de agente existente identificada pelo id.

Este endpoint cria uma nova variável dinâmica de agente com os dados fornecidos.

Este endpoint retorna os detalhes de uma variável dinâmica de agente especificada pelo identificador.

Este endpoint atualiza os dados de uma variável dinâmica de agente existente identificada pelo id.

Este endpoint remove uma variável dinâmica de agente existente identificada pelo id.

Este endpoint retorna o estado do agente em uma versão específica.

Este endpoint permite filtrar o histórico por agente (obrigatório), usuário, tipo de ação e período. Suporta paginação.

Este endpoint reverte o agente para o estado de uma versão específica.

Este endpoint retorna os detalhes de um registro de histórico específico.

Este endpoint retorna todas as ferramentas de um Agente de IA pelo identificador do Agente de IA.

Este endpoint cria uma nova ferramenta de agente com os dados fornecidos.

Este endpoint retorna os detalhes de uma ferramenta de agente especificada pelo identificador.

Este endpoint atualiza os dados de uma ferramenta de agente existente identificada pelo id.

Este endpoint remove uma ferramenta de agente existente identificada pelo id.

Este endpoint retorna todos os conhecimentos de agente cadastrados.

Este endpoint cria um novo conhecimento de agente com os dados fornecidos.

Este endpoint retorna os detalhes de um conhecimento de agente especificado pelo identificador.

Este endpoint atualiza os dados de um conhecimento de agente existente identificado pelo id.

Este endpoint remove um conhecimento de agente existente identificado pelo id.

Este endpoint retorna as skills do tenant e as skills globais habilitadas.

Este endpoint cria uma nova skill para o tenant atual.

Este endpoint retorna os detalhes de uma skill especificada pelo identificador.

Este endpoint atualiza uma skill do tenant atual.

Este endpoint remove uma skill do tenant atual.

This endpoint creates multiple batch phone calls for an ElevenLabs agent.

This endpoint creates a phone call for an ElevenLabs agent.

This endpoint returns the available ElevenLabs LLM models and safe capabilities for use with agents.

This endpoint returns the available voices from a specific provider (ElevenLabs) for use with agents.

Lists ElevenLabs tools referenced by the tenant. When agentId is greater than zero, also includes tools currently assigned to that ElevenLabs agent after checking view permission. Fetches tool details from ElevenLabs and returns them sorted by name; it does not execute tools.

Registers a tenant reference to an existing custom ElevenLabs tool. ToolId must match tool_ followed by letters or digits, and the tool must exist in the configured ElevenLabs account. System tools cannot be referenced. This operation does not create or execute the external tool and does not duplicate an existing reference.

Removes the tenant reference to the specified ElevenLabs tool after checking edit permission using agentId. This removes the reference stored in the connector; it does not delete the external tool or change the tools configured on the ElevenLabs agent.

Este endpoint cria uma ligação telefônica para um usuário interno e conecta com o cliente.

Este endpoint retorna todos os checklists cadastrados.

Este endpoint cria um novo checklist com os dados fornecidos.

Este endpoint retorna os detalhes de um checklist especificado pelo identificador.

Este endpoint atualiza os dados de um checklist existente identificado pelo id.

Este endpoint retorna os itens de um checklist específico.

Este endpoint cria um novo item de checklist com os dados fornecidos.

Este endpoint retorna os detalhes de um item de checklist especificado pelo identificador.

Este endpoint atualiza os dados de um item de checklist existente identificado pelo id.

Este endpoint deleta um item de checklist. Só é possível deletar se o item não estiver vinculado a nenhuma conversa.

Este endpoint dispara a reavaliação do checklist de uma ou mais conversas.

Este endpoint cria uma conversa a partir de um arquivo de audio e metadados.

Este endpoint importa conversas originadas do Microsoft Teams.

Este endpoint recebe e e-mails e envia para o Agente de IA responder.

Este endpoint cria uma conversa proativa com os dados fornecidos.

Este endpoint retorna templates de conversa conforme os filtros informados.

Este endpoint cria um novo template de conversa com os dados fornecidos.

Este endpoint retorna os detalhes de um template de conversa especificado pelo identificador.

Este endpoint atualiza os dados de um template de conversa existente identificado pelo id.

Este endpoint deleta template de WhatsApp.

Este endpoint dispara uma verificação manual do status de aprovação do template de conversa no provedor.

Este endpoint retorna todas as conversas que atendem ao filtro informado, com itens de checklist opcionais.

Este endpoint retorna as conversas paginadas conforme o filtro informado.

Este endpoint retorna os detalhes de uma conversa especificada pelo identificador.

Este endpoint retorna as mensagens de uma conversa especificada pelo identificador da conversa.

Este endpoint cria uma nova mensagem, opcionalmente com arquivo, para uma conversa.

Este endpoint reenvia uma mensagem já existente pelo seu identificador.

Este endpoint retorna os detalhes de uma mensagem especificada pelo identificador.

Este endpoint atualiza os dados de uma mensagem existente identificada pelo id.

Este endpoint marca uma mensagem específica como lida pelo usuário.

Este endpoint cria um novo documento, opcionalmente com arquivo, com os dados fornecidos.

Este endpoint retorna informações resumidas e estatísticas dos documentos para exibição em dashboard. Permite filtrar por período (createdAtStart e createdAtEnd).

Este endpoint retorna documentos paginados conforme o filtro informado.

Este endpoint retorna os detalhes de um documento especificado pelo identificador.

Este endpoint remove um documento existente identificado pelo id.

Este endpoint reprocessa um documento existente identificado pelo id.

Retorna a lista de fluxos do tenant do usuário autenticado.

Cria um registro de fluxo com os dados do corpo da requisição e retorna o registro criado.

Retorna os totais dos fluxos com tarefas que atendem aos filtros, tarefas por status e tarefas com participação de usuários ou agentes registrada no histórico. Permite filtrar por fluxo, status e intervalos inclusivos de criação e conclusão. Agrupa os períodos pela data de criação das tarefas, por dia ou mês; o padrão é dia. Uma tarefa pode ser contada tanto na participação humana quanto na de IA. Não altera tarefas nem executa agentes.

Retorna os dados de fluxo identificado por id no tenant do usuário autenticado. Retorna 404 quando o registro não é encontrado.

Atualiza os dados de fluxo identificado por id usando o corpo da requisição. Retorna 204 sem conteúdo.

Exclui o registro de fluxo identificado por id. Retorna 204 sem conteúdo.

Retorna a lista de recorrências de tarefas do tenant do usuário autenticado.

Cadastra uma regra de geração recorrente de tarefas para um fluxo e uma raia do mesmo tenant. Informe título, padrão, intervalo, data e horário locais, fuso horário e limite da recorrência. Valida a regra e calcula a primeira ocorrência em UTC; esta requisição cadastra a recorrência, sem gerar tarefas imediatamente.

Retorna os dados de recorrência de tarefas identificado por id no tenant do usuário autenticado. Retorna 404 quando o registro não é encontrado.

Atualiza a regra de recorrência identificada por id e recalcula a próxima ocorrência em UTC. Preserva a quantidade de ocorrências já geradas e a última ocorrência. Informe os dados completos da regra; o fluxo e a raia devem pertencer ao mesmo tenant e a raia ao fluxo selecionado.

Exclui o registro de recorrência de tarefas identificado por id. Retorna 204 sem conteúdo.

Retorna a previsão das próximas ocorrências, considerando exceções ainda não processadas, reagendamentos e cancelamentos. Os horários original e agendado são retornados em UTC, ordenados pelo horário agendado. O parâmetro count tem padrão 50 e é ajustado ao intervalo de 1 a 200. A consulta não gera tarefas nem executa agentes.

Cadastra uma raia vinculada a um fluxo, com nome, ordem, responsáveis, sinalizadores de início e fim, cor e limite de tarefas em andamento (WipLimit).

Retorna os dados de raia de fluxo identificado por id no tenant do usuário autenticado. Retorna 404 quando o registro não é encontrado.

Atualiza os dados da raia identificada por id. Informe o fluxo, nome, ordem, responsáveis e demais configurações no corpo da requisição.

Exclui o registro de raia de fluxo identificado por id. Retorna 204 sem conteúdo.

Cadastra uma tarefa vinculada a um fluxo e uma raia, com título, descrição, status, prioridade, payload e prazo informados no corpo da requisição.

Retorna os dados de tarefa de fluxo identificado por id no tenant do usuário autenticado. Retorna 404 quando o registro não é encontrado.

Atualiza a tarefa identificada por id. Se CurrentFlowStageId mudar, a operação move a tarefa para a raia de destino e pode agendar a execução do agente responsável por essa raia; nesse caso, os demais campos enviados não são atualizados por esta operação. Sem mudança de raia, atualiza os dados da tarefa pelo comportamento de atualização comum. A movimentação pode produzir efeitos externos pela execução do agente.

Exclui o registro de tarefa de fluxo identificado por id. Retorna 204 sem conteúdo.

Cadastra um registro de histórico vinculado a uma tarefa, com tipo de evento, raias de origem e destino, usuário ou agente, descrição e payload informados. O registro documenta um evento; esta operação não movimenta a tarefa nem executa agentes.

Retorna os dados de registro de histórico de tarefa identificado por id no tenant do usuário autenticado. Retorna 404 quando o registro não é encontrado.

Atualiza os dados de registro de histórico de tarefa identificado por id usando o corpo da requisição. Retorna 204 sem conteúdo.

Exclui o registro de registro de histórico de tarefa identificado por id. Retorna 204 sem conteúdo.

Retorna as associações entre o agente informado e conectores MCP do tenant, incluindo o estado de habilitação e os nomes das ferramentas permitidas. Requer ViewAgents.

Cria uma associação entre agente e conector MCP do mesmo tenant. Informe Enabled e a lista AllowedTools; uma lista vazia não libera ferramentas. Não permite duplicar o mesmo conector para um agente. Requer UpdateAgent e ViewConnectors.

Conecta ao servidor MCP configurado no conector do tenant e consulta os nomes, descrições e schemas das ferramentas disponíveis. Faz uma chamada ao servidor externo, mas não executa as ferramentas nem as autoriza automaticamente para um agente. Requer ViewConnectors.

Retorna os dados e as ferramentas permitidas da associação MCP identificada por id no tenant autenticado. Requer ViewAgents.

Atualiza Enabled e substitui a lista AllowedTools da associação. AgentId e ConnectorId devem permanecer iguais aos da associação existente; para trocar o agente ou conector, crie outra associação. Requer UpdateAgent e ViewConnectors.

Exclui a associação MCP identificada por id, revogando seu uso pelo agente. Não exclui o agente nem o conector. Requer UpdateAgent.

Retorna os departamentos do tenant do usuário autenticado.

Cria um departamento com nome, cota mensal em BRL e membros informados em TenantUserIds. Os membros devem pertencer ao tenant autenticado. Cota null significa ilimitada; zero bloqueia o uso; valores negativos são inválidos.

Retorna o consumo do mês atual em UTC, o limite mensal e a indicação de bloqueio por cota do tenant autenticado. Não altera limites nem registra consumo.

Retorna o departamento identificado por id, incluindo a cota mensal e os IDs de seus membros.

Atualiza nome, cota mensal e a lista completa de membros do departamento. Membros omitidos da lista são removidos. TenantUserIds deve conter apenas membros do tenant autenticado. Cota null significa ilimitada; zero bloqueia o uso.

Exclui o departamento identificado por id. A operação é recusada enquanto houver agentes vinculados ao departamento; remova esses vínculos antes de excluir.

Retorna o consumo do mês atual em UTC, os limites do tenant e do departamento e a indicação de bloqueio por cota. Não altera limites nem registra consumo.

Consulta o dashboard de consumo conforme os filtros do corpo da requisição. Retorna um resumo de agentes, valores contratados e consumidos, consumo por item e dia e dimensões de consumo. Apesar de usar POST, esta operação é uma consulta e não registra consumo nem altera cotas.

Retorna as configurações de webhooks do tenant autenticado, incluindo nome, URL de destino, tipo de evento e estado de habilitação. Requer ViewWebhooks.

Cadastra uma configuração de webhook com nome, URL de destino, tipo de evento e estado de habilitação. Não envia uma notificação de teste nesta requisição. Requer CreateWebhook. Retorna 200 sem o registro criado no corpo.

Retorna a configuração do webhook identificado por id no tenant autenticado. Requer ViewWebhooks.

Atualiza a configuração do webhook identificado por id usando nome, URL de destino, tipo de evento e habilitação enviados no corpo. Não envia uma notificação de teste nesta requisição. Requer UpdateWebhook. Retorna 200 sem conteúdo.

Esta rota atualmente retorna sucesso sem excluir ou alterar o webhook. A chamada ao serviço de exclusão não está implementada no controller; não use esta operação para confirmar que um webhook foi removido.