ZSales

Showing 25 of 207 from the live probe.

• Health Check

  Status do MCP server e lista de tools registradas.

• List My Organizations

  Lista as organizações em que este token MCP pode atuar. Use o `id` retornado como `organization_id` nas demais tools quando houver mais de uma org disponível.

• List My Networks

  Lista as REDES (workspaces) que agrupam as unidades autorizadas neste token, com a hierarquia entre elas e as unidades de cada uma. Use antes de comparar ou somar números de unidades diferentes: só faz sentido consolidar unidades da MESMA rede. `parent_id` monta a árvore (holding acima do franqueado, franqueado acima das franquias); `root_id` diz qual é a raiz.

• List Scope Units

  Unidades que podem entrar no recorte (`organizations`) de um relatório ou painel ancorado nesta unidade. Chame ANTES de `create_report`/`create_dashboard` com uma lista de ids: o servidor recusa unidade fora daqui, e sem consultar não há como prever o que ele aceita. É alcance ∩ fronteira de consolidação — nem toda unidade que o token alcança pode ser somada com esta (somar franquias de donos diferentes não descreve negócio nenhum). Uma unidade só na lista significa que não há o que consolidar;

• Send Message

  Envia uma mensagem do agente IA na conversa indicada, via canal (WhatsApp/Telegram/etc). Devolve o DESFECHO em `send_status`: `sent` (saiu, com `external_id` do canal), `failed` (falhou) ou `sending` com `pending=true` (ainda em trânsito — NÃO afirme que foi enviada; confira depois pelo `message_id`). Requer permissão `conversations.edit` no group do agente.

• Create Conversation

  Cria uma nova conversa em um canal específico, opcionalmente já vinculada a um contato. Requer permissão `conversations.add`.

• Assign Conversation

  Atribui (ou remove atribuição de) uma conversa. Passe assignee_user_id=0 ou null pra deixar não atribuída. Dispara broadcast WS pro responsável antigo e novo. Requer permissão `conversations.assign`.

• Resolve Conversation

  Resolve uma conversa (status=resolved). Requer permissão `conversations.change`.

• Reopen Conversation

  Reabre uma conversa resolvida (status=open). Requer permissão `conversations.change`.

• Mark Conversation Read

  Marca a conversa como lida (zera unread_count). Requer permissão `conversations.change`.

• Merge Conversations

  Mescla duas conversas: move mensagens da `source_id` pra `target_id` e deleta a source. Útil quando o mesmo cliente abriu 2 conversas paralelas. Requer permissão `conversations.merge`.

• Assign Conversations Bulk

  Atribui múltiplas conversas ao mesmo responsável de uma vez. Útil pra redistribuição em massa. Requer permissão `conversations.assign`.

• List Conversations

  Lista conversas da organização (mais recentes primeiro). Cada conversa traz `message_count` (nº real de mensagens). Para ANALISAR o conteúdo das conversas, use as que têm `message_count > 0` (ou passe `min_messages=1`) — uma conversa com 0 mensagens é uma casca/duplicata ou um lead nunca contatado. Um mesmo contato pode ter mais de uma conversa. Requer permissão `conversations.view`.

• Search Messages

  Busca TEXTO dentro das mensagens de todas as conversas da organização e devolve os trechos que casaram, com a conversa de origem. Use isto ANTES de abrir conversas uma por uma: uma chamada localiza onde o assunto aparece (ex.: 'cancelar', 'reembolso', nome de um produto), e só então use `get_conversation` nos ids relevantes. `total_count` é quantas mensagens casaram e `conversation_count` em quantas conversas distintas — ambos sobre o total, não sobre a amostra devolvida. Cada resultado traz um

• Get Conversation

  Detalha uma conversa com as últimas mensagens e o `message_count`. Se esta conversa estiver VAZIA (message_count=0) mas o contato tiver outra conversa com histórico, o campo `sibling_with_messages` aponta o id da conversa certa — abra essa para analisar o conteúdo. Mensagens de mídia (imagem/áudio/documento) aparecem como '[tipo] arquivo'. Requer permissão `conversations.view`.

• Search Contacts

  Busca contatos por nome, telefone ou email — o telefone pode vir em qualquer formato (com DDI, parênteses, hífen ou só dígitos). Devolve `total_count` (quantos existem) e `truncated`; para CONTAR use `total_count`, não `count`, que é só a amostra. `searched` mostra os valores canônicos consultados. Requer permissão `contacts.view`.

• Get Contact

  Detalha um contato com as conversas vinculadas. Requer permissão `contacts.view`.

• Create Contact

  Cria um novo contato. Telefone e email são opcionais — quando fornecidos, viram ContactIdentifier primários. Requer permissão `contacts.add`.

• Update Contact

  Atualiza campos de um contato. Só altera os campos passados (PATCH semântico). Requer permissão `contacts.change`.

• Delete Contact

  Remove um contato. Conversas e mensagens vinculadas seguem com `contact=null`. Requer permissão `contacts.delete`.

• Merge Contacts

  Mescla o contato `source_id` no `target_id`, movendo conversas, mensagens, identifiers e oportunidades. O source é deletado ao final. Use quando um mesmo cliente foi cadastrado duas vezes. Requer permissão `contacts.merge`.

• List Customers

  Lista clientes por nome, e-mail, DOCUMENTO (CPF/CNPJ em qualquer formato) ou TELEFONE do contato vinculado. Devolve `total_count` (quantos existem) e `truncated`; para CONTAR use `total_count`, não `count`, que é só a amostra. Requer permissão `customers.view`.

• Get Customer

  Detalha um cliente. Requer permissão `customers.view`.

• Lookup Customer By Email

  Busca usuário global por email para vínculo como cliente. Requer permissão `customers.view`.

• Create Customer

  Cria ou vincula um cliente na organização. Requer permissão `customers.create`.