{
  "info": {
    "name": "Trendmulti API",
    "description": "Coleção da API pública da Trendmulti, gerada a partir do contrato OpenAPI do portal do desenvolvedor.\n\n**Para começar**\n1. Na aba **Variables** da coleção, preencha `channelUuid` e `channelToken` com as credenciais de API de um canal conectado e, para as rotas do chat interno, `agentKey` com a chave do agente de integração.\n2. Execute **POST /api/auth**: o token devolvido vai sozinho para `bearerToken` e vale para todas as outras requisições, por 1 dia.\n3. Chame qualquer outra rota. As rotas do chat interno também enviam o cabeçalho `X-Agent-Key` com `{{agentKey}}`.\n\nGuias, limites e erros: https://developer.trendmulti.com.br",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Autenticação",
      "item": [
        {
          "name": "Autenticação",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/auth",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "auth"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"uuid\": \"{{channelUuid}}\",\n  \"token\": \"{{channelToken}}\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "auth": {
              "type": "noauth"
            },
            "description": "Utiliza seu email e senha para autenticar na API e garantir seu token de autorização para navegar na API"
          },
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// Saves the access token for every other request of the collection.",
                  "const body = pm.response.json();",
                  "if (body && body.token) {",
                  "  pm.collectionVariables.set('bearerToken', body.token);",
                  "}"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "Info",
      "item": [
        {
          "name": "Informações do Canal",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/api/info",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "info"
              ]
            },
            "description": "Recupera as informações do canal autenticado"
          }
        }
      ]
    },
    {
      "name": "Contatos",
      "item": [
        {
          "name": "Lista de Contatos da Empresa",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/contact/pager?page=1&perPage=20&search=maria",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "contact",
                "pager"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1"
                },
                {
                  "key": "perPage",
                  "value": "20"
                },
                {
                  "key": "search",
                  "value": "maria"
                }
              ]
            },
            "description": "Recupera os contatos da empresa paginados e por filtros"
          }
        },
        {
          "name": "Consulta por ID",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/contact/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "contact",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Identificador"
                }
              ]
            },
            "description": "Recupera um contato pelo identificador"
          }
        },
        {
          "name": "Cria um novo Contato",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/contact/create",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "contact",
                "create"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"\",\n  \"phone\": \"\",\n  \"email\": \"\",\n  \"image\": \"\",\n  \"tags\": [],\n  \"customFields\": [\n    {\n      \"id\": \"\",\n      \"value\": \"\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Realiza a criação de um novo Contato. Aceita etiquetas (tags, de GET /tag/list) e campos personalizados (customFields, de GET /custom-field/list). Etiquetas que não são da empresa são ignoradas."
          }
        },
        {
          "name": "Atualiza dados de um Contato",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/contact/update",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "contact",
                "update"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"id\": \"\",\n  \"name\": \"\",\n  \"phone\": \"\",\n  \"email\": \"\",\n  \"image\": \"\",\n  \"tags\": [],\n  \"customFields\": [\n    {\n      \"id\": \"\",\n      \"value\": \"\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Realiza a atualização dos dados de um Contato. Só os campos enviados mudam. tags, quando enviada, substitui as etiquetas do contato. customFields grava os campos enviados e mantém os demais; value null remove um campo."
          }
        }
      ]
    },
    {
      "name": "Etiquetas",
      "item": [
        {
          "name": "Lista de Etiquetas",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/tag/list",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "tag",
                "list"
              ]
            },
            "description": "Recupera a lista de todas as etiquetas da empresa"
          }
        },
        {
          "name": "Consulta por ID",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/tag/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "tag",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Identificador"
                }
              ]
            },
            "description": "Recupera um canal pelo identificador"
          }
        },
        {
          "name": "Cria uma nova Etiqueta",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/tag/create",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "tag",
                "create"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"title\": \"\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Realiza a criação de uma nova Etiqueta"
          }
        },
        {
          "name": "Atualiza dados de uma Etiqueta",
          "request": {
            "method": "PUT",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/tag/update",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "tag",
                "update"
              ]
            },
            "description": "Realiza a atualização dos dados de uma etiqueta"
          }
        }
      ]
    },
    {
      "name": "Departamentos",
      "item": [
        {
          "name": "Lista de Canais da Empresa",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/department/list",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "department",
                "list"
              ]
            },
            "description": "Recupera a lista de todos os canais da empresa"
          }
        },
        {
          "name": "Consulta por ID",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/department/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "department",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Identificador"
                }
              ]
            },
            "description": "Recupera um contato pelo identificador"
          }
        }
      ]
    },
    {
      "name": "Usuários",
      "item": [
        {
          "name": "Lista de Usuários",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/user/list",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "user",
                "list"
              ]
            },
            "description": "Recupera a lista de todos os usuários da empresa"
          }
        },
        {
          "name": "Consulta por ID",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/user/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "user",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Identificador"
                }
              ]
            },
            "description": "Recupera um contato pelo identificador"
          }
        }
      ]
    },
    {
      "name": "Atendimentos",
      "item": [
        {
          "name": "Lista de Atendimentos da Empresa",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/attendance/pager?page=1&perPage=20",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "attendance",
                "pager"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1"
                },
                {
                  "key": "perPage",
                  "value": "20"
                }
              ]
            },
            "description": "Recupera os atendimentos do canal paginados"
          }
        },
        {
          "name": "Lista de Atendimentos por Situação (Status)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/attendance/pager/status?page=1&perPage=20&status=IN_PROGRESS",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "attendance",
                "pager",
                "status"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1"
                },
                {
                  "key": "perPage",
                  "value": "20"
                },
                {
                  "key": "status",
                  "value": "IN_PROGRESS"
                }
              ]
            },
            "description": "Recupera os atendimentos da empresa paginados e pelas situações: \"Fora de horário\", \"Aguardando\", \"Em andamento\", \"Em pausa\" e \"Encerrados\""
          }
        },
        {
          "name": "Consulta por ID",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/attendance/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "attendance",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Identificador"
                }
              ]
            },
            "description": "Recupera um atendimento pelo identificador"
          }
        },
        {
          "name": "Adiciona etiquetas ao atendimento",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/attendance/:id/tags",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "attendance",
                ":id",
                "tags"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Identificador do atendimento"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"tags\": [\n    \"64b7f0c2a1b2c3d4e5f60718\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Adiciona as etiquetas informadas a um atendimento não encerrado e também ao contato dele, como faz o painel de atendimento, registrando cada etiqueta adicionada na linha do tempo. Uma etiqueta que o atendimento já tem não muda nada. Retorna o atendimento atualizado."
          }
        },
        {
          "name": "Remove uma etiqueta do atendimento",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/attendance/:id/tags/:idTag",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "attendance",
                ":id",
                "tags",
                ":idTag"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Identificador do atendimento"
                },
                {
                  "key": "idTag",
                  "value": "",
                  "description": "Identificador da etiqueta"
                }
              ]
            },
            "description": "Remove a etiqueta de um atendimento não encerrado e também do contato dele, como faz o painel de atendimento, registrando a remoção na linha do tempo. Uma etiqueta que o atendimento não tem não muda nada. Retorna o atendimento atualizado."
          }
        },
        {
          "name": "Envia um sussurro no atendimento",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/attendance/:id/whisper",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "attendance",
                ":id",
                "whisper"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Identificador do atendimento"
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"content\": \"\",\n  \"idUser\": \"\",\n  \"clientId\": \"\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Cria um sussurro: uma orientação privada dentro da conversa, que só a equipe da empresa vê — o cliente nunca recebe. O responsável pelo atendimento é avisado no painel. Com idUser, o sussurro aparece em nome desse administrador ou supervisor; sem ele, aparece como \"Integração\". O atendimento precisa estar aberto. A API só cria sussurros: ela não lista nem devolve sussurros, e eles nunca aparecem nas mensagens do atendimento (GET /message/pager). Por isso a resposta não traz o texto."
          }
        }
      ]
    },
    {
      "name": "Mensagens para Atendimentos do Canal",
      "item": [
        {
          "name": "Lista Mensagens do Canal",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/message/pager?page=1&perPage=20&idAttendance=6563f0c2a1b2c3d4e5f60718",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "message",
                "pager"
              ],
              "query": [
                {
                  "key": "page",
                  "value": "1",
                  "description": "Página de resultados, a partir de 1. Padrão: 1."
                },
                {
                  "key": "perPage",
                  "value": "20",
                  "description": "Registros por página. Padrão: 20. Máximo: 100 (acima disso a requisição é recusada)."
                },
                {
                  "key": "idAttendance",
                  "value": "6563f0c2a1b2c3d4e5f60718",
                  "description": "Identificador do atendimento."
                },
                {
                  "key": "idContact",
                  "value": "",
                  "description": "Identificador do contato. Traz as mensagens do contato; sem idAttendance, apenas as do canal do token.",
                  "disabled": true
                },
                {
                  "key": "phone",
                  "value": "",
                  "description": "Telefone em formato internacional, com DDI e DDD (ex.: 5511999998888); sem o DDI nada é encontrado. Traz as mensagens cujo remetente (from) é esse número (sem idAttendance, apenas no canal do token); o nono dígito é opcional. Usado sozinho, considera os contatos que hoje possuem o número.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "OVERTIME",
                  "description": "Status do atendimento ao qual a mensagem pertence. Aceita vários valores separados por vírgula. Exige idAttendance, idContact ou phone.",
                  "disabled": true
                }
              ]
            },
            "description": "Recupera mensagens paginadas, das mais recentes para as mais antigas (pela data de criação; mensagens com a mesma data não têm ordem garantida entre si). Informe ao menos um dos filtros idAttendance, idContact ou phone; os filtros informados são combinados (E). O filtro phone traz apenas as mensagens cujo remetente é aquele número. O filtro status considera o status atual do atendimento da mensagem e não pode ser usado sozinho: exige ao menos um dos outros filtros. Sem idAttendance, o resultado fica restrito ao canal do token; com idAttendance, vale o atendimento informado. Uma página menor que perPage é a última; perPage aceita de 1 a 100 registros."
          }
        },
        {
          "name": "Consulta por ID",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/message/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "message",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Identificador"
                }
              ]
            },
            "description": "Recupera uma mensagem pelo identificador"
          }
        },
        {
          "name": "Enviar mensagem para um Atendimento",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/message/sendMessage",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "message",
                "sendMessage"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"idContact\": \"6563f0c2a1b2c3d4e5f60718\",\n  \"type\": \"text\",\n  \"content\": \"Olá! Seu pedido foi confirmado.\",\n  \"automated\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Envia mensagem para um atendimento"
          }
        },
        {
          "name": "Enviar mensagem para um Atendimento",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/message/sendReplyButtonMessage",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "message",
                "sendReplyButtonMessage"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"idContact\": \"\",\n  \"idDepartment\": \"\",\n  \"idUser\": \"\",\n  \"header\": {\n    \"type\": \"text\",\n    \"document\": {\n      \"id\": \"\",\n      \"link\": \"\"\n    },\n    \"image\": {\n      \"id\": \"\",\n      \"link\": \"\"\n    },\n    \"text\": \"\",\n    \"video\": {\n      \"id\": \"\",\n      \"link\": \"\"\n    }\n  },\n  \"body\": {\n    \"text\": \"\"\n  },\n  \"footer\": {\n    \"text\": \"\"\n  },\n  \"buttons\": [\n    {\n      \"type\": \"\",\n      \"reply\": {\n        \"title\": \"\",\n        \"id\": \"\"\n      }\n    }\n  ],\n  \"automated\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Envia mensagem para um atendimento"
          }
        },
        {
          "name": "Busca o status de uma mensagem enviada",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/message/getMessageStatus/:messageId",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "message",
                "getMessageStatus",
                ":messageId"
              ],
              "variable": [
                {
                  "key": "messageId",
                  "value": ""
                }
              ]
            },
            "description": "Busca o status de uma mensagem enviada pelo ID da mensagem"
          }
        },
        {
          "name": "Lista de Templates (Somente Canal Oficial)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/message/list/templates",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "message",
                "list",
                "templates"
              ]
            },
            "description": "Recupera templates de mensagens de um canal oficial"
          }
        },
        {
          "name": "Enviar Mensagem de Template para um Atendimento (Somente Canal Oficial)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/message/sendTemplateMessage",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "message",
                "sendTemplateMessage"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"idContact\": \"\",\n  \"idDepartment\": \"\",\n  \"idUser\": \"\",\n  \"template\": \"\",\n  \"headerParams\": [],\n  \"bodyParams\": []\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Envia mensagem de template para um atendimento"
          }
        }
      ]
    },
    {
      "name": "CRM",
      "item": [
        {
          "name": "Lista de Funis da Empresa",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/crm/funnel/list",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "funnel",
                "list"
              ]
            },
            "description": "Recupera os funis da empresa"
          }
        },
        {
          "name": "Cria um novo Funil",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/funnel/create",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "funnel",
                "create"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Realiza a criação de um novo Funil"
          }
        },
        {
          "name": "Atualiza dados de um Funil",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/funnel/update",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "funnel",
                "update"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"id\": \"\",\n  \"name\": \"\",\n  \"description\": \"\",\n  \"category\": {}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Realiza a atualização dos dados de um funil existente"
          }
        },
        {
          "name": "Lista de Etapas do Funil informado",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/crm/stage/list/:idFunnel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "stage",
                "list",
                ":idFunnel"
              ],
              "variable": [
                {
                  "key": "idFunnel",
                  "value": ""
                }
              ]
            },
            "description": "Recupera as etapas do funil informado"
          }
        },
        {
          "name": "Cria uma nova etapa para o funil informado",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/stage/create/:idFunnel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "stage",
                "create",
                ":idFunnel"
              ],
              "variable": [
                {
                  "key": "idFunnel",
                  "value": ""
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Realiza a criação de uma nova etapa para o funil informado"
          }
        },
        {
          "name": "Atualiza dados de uma Etapa existente",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/stage/update",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "stage",
                "update"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"id\": \"\",\n  \"name\": \"\",\n  \"order\": 0,\n  \"bgColor\": \"\",\n  \"lostDeal\": false,\n  \"wonDeal\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Realiza a atualização dos dados de uma etapa existente"
          }
        },
        {
          "name": "Lista de Produtos da Empresa",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/crm/product/list",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "product",
                "list"
              ]
            },
            "description": "Recupera os produtos da empresa"
          }
        },
        {
          "name": "Cria um novo Produto",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/product/create",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "product",
                "create"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"\",\n  \"price\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Realiza a criação de um novo Produto"
          }
        },
        {
          "name": "Atualiza dados de um Produto",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/product/update",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "product",
                "update"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"id\": \"\",\n  \"name\": \"\",\n  \"description\": \"\",\n  \"code\": \"\",\n  \"price\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Realiza a atualização dos dados de um produto existente"
          }
        },
        {
          "name": "Lista de Clientes da Empresa",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/crm/customer/list",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "customer",
                "list"
              ]
            },
            "description": "Recupera os clientes da empresa"
          }
        },
        {
          "name": "Cria um novo Cliente",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/customer/create",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "customer",
                "create"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"\",\n  \"phone\": \"\",\n  \"email\": \"\",\n  \"code\": \"\",\n  \"legalName\": \"\",\n  \"tradeName\": \"\",\n  \"tin\": \"\",\n  \"stateRegistration\": \"\",\n  \"website\": \"\",\n  \"instagram\": \"\",\n  \"segment\": \"\",\n  \"employeeBand\": \"\",\n  \"address\": {}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Realiza a criação de um novo Cliente. A pessoa é encontrada pelo telefone (ou criada como contato, quando nenhum contato o tem) e passa a ser o contato principal do cliente."
          }
        },
        {
          "name": "Atualiza dados de um Cliente",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/customer/update",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "customer",
                "update"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"\",\n  \"code\": \"\",\n  \"legalName\": \"\",\n  \"tradeName\": \"\",\n  \"tin\": \"\",\n  \"stateRegistration\": \"\",\n  \"website\": \"\",\n  \"instagram\": \"\",\n  \"segment\": \"\",\n  \"employeeBand\": \"\",\n  \"address\": {},\n  \"id\": \"\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Realiza a atualização dos dados de um cliente existente. Telefone, e-mail e contato seguem o contato principal e não mudam por aqui: altere-os pelo contato (PUT /contact/update). Reenviar os valores atuais é aceito."
          }
        },
        {
          "name": "Lista de Motivos de Perda da Empresa",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/crm/loss-reason/list",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "loss-reason",
                "list"
              ]
            },
            "description": "Recupera os motivos de perda da empresa"
          }
        },
        {
          "name": "Cria um novo Motivo de Perda",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/loss-reason/create",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "loss-reason",
                "create"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"\",\n  \"description\": \"\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Realiza a criação de um novo Motivo de Perda"
          }
        },
        {
          "name": "Atualiza dados de um Motivo de Perda",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/loss-reason/update",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "loss-reason",
                "update"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"id\": \"\",\n  \"name\": \"\",\n  \"description\": \"\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Realiza a atualização dos dados de um motivo de perda existente"
          }
        }
      ]
    },
    {
      "name": "CRM - Oportunidade",
      "item": [
        {
          "name": "Lista de Oportunidades da Empresa usando o ID de um funil",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/crm/card/list/:idFunnel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "card",
                "list",
                ":idFunnel"
              ],
              "variable": [
                {
                  "key": "idFunnel",
                  "value": ""
                }
              ]
            },
            "description": "Recupera as oportunidades da empresa"
          }
        },
        {
          "name": "Cria uma nova Oportunidade para o funil e etapa informados",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/card/create/:idFunnel/:idStage",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "card",
                "create",
                ":idFunnel",
                ":idStage"
              ],
              "variable": [
                {
                  "key": "idFunnel",
                  "value": ""
                },
                {
                  "key": "idStage",
                  "value": ""
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"\",\n  \"description\": \"\",\n  \"priority\": \"NO PRIORITY\",\n  \"temperature\": \"COLD\",\n  \"order\": 0,\n  \"budget\": 0,\n  \"customer\": {},\n  \"product\": {},\n  \"user\": {},\n  \"attendance\": {},\n  \"lossReason\": {},\n  \"funnel\": {},\n  \"stage\": {},\n  \"won\": false,\n  \"deadlineAt\": \"\",\n  \"isPrivate\": false,\n  \"closedAt\": \"\",\n  \"winDate\": \"\",\n  \"lostDate\": \"\",\n  \"attachments\": [\n    {\n      \"filename\": \"\",\n      \"contentType\": \"\",\n      \"size\": 0,\n      \"url\": \"\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Cria uma nova oportunidade para o funil e etapa informados"
          }
        },
        {
          "name": "Atualiza dados de uma Oportunidade",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/crm/card/update",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "card",
                "update"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"id\": \"\",\n  \"name\": \"\",\n  \"description\": \"\",\n  \"budget\": 0,\n  \"customer\": {},\n  \"product\": {},\n  \"user\": {},\n  \"lossReason\": {},\n  \"isPrivate\": false,\n  \"closedAt\": \"\",\n  \"winDate\": \"\",\n  \"lostDate\": \"\",\n  \"attachments\": [\n    {\n      \"filename\": \"\",\n      \"contentType\": \"\",\n      \"size\": 0,\n      \"url\": \"\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Realiza a atualização dos dados de uma Oportunidade"
          }
        },
        {
          "name": "Mover uma oportunidade para uma nova etapa",
          "request": {
            "method": "PUT",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/crm/card/update/:idCard/stage?idNewStage=6563f0c2a1b2c3d4e5f60725",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "crm",
                "card",
                "update",
                ":idCard",
                "stage"
              ],
              "query": [
                {
                  "key": "idNewStage",
                  "value": "6563f0c2a1b2c3d4e5f60725"
                },
                {
                  "key": "idLossReason",
                  "value": "",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "idCard",
                  "value": ""
                }
              ]
            },
            "description": "Atualiza a etapa de uma oportunidade. Quando a etapa destino for de perda, o Motivo da Perda se torna obrigatório."
          }
        }
      ]
    },
    {
      "name": "Campos personalizados",
      "item": [
        {
          "name": "Lista de Campos Personalizados de Contato",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/custom-field/list",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "custom-field",
                "list"
              ]
            },
            "description": "Recupera os campos personalizados de contato da empresa, com o identificador e o tipo de cada um. Use o identificador em customFields ao criar ou atualizar um contato."
          }
        }
      ]
    },
    {
      "name": "Chat interno",
      "item": [
        {
          "name": "Lista os canais públicos do chat interno",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-Agent-Key",
                "value": "{{agentKey}}",
                "description": "Chave do agente de integração (tmca_…), copiada por um administrador em Agentes de integração, no chat. O valor {{agentKey}} é a variável da coleção Postman: troque pela chave ao testar no Swagger."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/chat/channels?name=alertas",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "chat",
                "channels"
              ],
              "query": [
                {
                  "key": "name",
                  "value": "alertas",
                  "description": "Parte do nome do canal, sem diferenciar maiúsculas de minúsculas (até 80 caracteres)."
                }
              ]
            },
            "description": "Lista os canais públicos e não arquivados do chat interno da empresa, por ordem de nome, com no máximo 500 canais. Canais privados, conversas diretas e conversas em grupo nunca aparecem. Use o id de um canal para publicar mensagens nele. Exige o token (Bearer) e a chave do agente de integração no cabeçalho X-Agent-Key."
          }
        },
        {
          "name": "Cria um canal público (ou devolve o existente)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-Agent-Key",
                "value": "{{agentKey}}",
                "description": "Chave do agente de integração (tmca_…), copiada por um administrador em Agentes de integração, no chat. O valor {{agentKey}} é a variável da coleção Postman: troque pela chave ao testar no Swagger."
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/chat/channels",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "chat",
                "channels"
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"alertas-pipeline\",\n  \"description\": \"Falhas dos pipelines de dados\",\n  \"members\": [\n    \"ana@empresa.com.br\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Cria um canal público no chat interno, mostrado com o agente como criador. O agente não vira membro do canal. Os e-mails de members que são usuários ativos da empresa entram como membros; cada e-mail não adicionado volta em notAdded, com o motivo. Se já existe um canal público ativo com o mesmo nome (sem diferenciar maiúsculas de minúsculas), a resposta é 200 com esse canal e existed: true, e ninguém é adicionado. Um nome em uso por um canal privado ou arquivado é recusado. Agentes só criam canais públicos."
          }
        },
        {
          "name": "Publica uma mensagem em um canal público",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-Agent-Key",
                "value": "{{agentKey}}",
                "description": "Chave do agente de integração (tmca_…), copiada por um administrador em Agentes de integração, no chat. O valor {{agentKey}} é a variável da coleção Postman: troque pela chave ao testar no Swagger."
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/chat/channels/:id/messages",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "chat",
                "channels",
                ":id",
                "messages"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Identificador do canal (GET /chat/channels)."
                }
              ]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"text\": \"@ana@empresa.com.br o pipeline **faturamento-diario** falhou na etapa _exportar_.\",\n  \"mentions\": [\n    \"ana@empresa.com.br\"\n  ],\n  \"clientId\": \"faturamento-diario-2026-11-21\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            },
            "description": "Publica uma mensagem em nome do agente em um canal público e não arquivado da empresa, sem que o agente seja membro do canal. Os membros recebem a mensagem como a de uma pessoa: em tempo real, com contador de não lidas, alertas e push para quem foi mencionado. Envie JSON ou, com arquivos, multipart/form-data: até 5 arquivos de até 10 MB cada, no campo files, e os demais campos como campos do formulário. Arquivos executáveis são recusados. O texto aceita a formatação leve do chat, até 12000 caracteres. Para mencionar, liste os e-mails em mentions: viram menção os membros do canal, e cada e-mail não mencionado volta em notMentioned, com o motivo. Escreva @email no texto para indicar onde a menção aparece; o chat mostra o nome da pessoa. thread publica a mensagem como resposta na conversa de uma mensagem anterior do mesmo canal. clientId identifica o envio: repetir o mesmo clientId não publica de novo e devolve, com status 200, a mensagem publicada da primeira vez. Cada agente pode publicar até 60 mensagens por minuto."
          }
        },
        {
          "name": "Publica uma mensagem em um canal público (com arquivos)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-Agent-Key",
                "value": "{{agentKey}}",
                "description": "Chave do agente de integração (tmca_…), copiada por um administrador em Agentes de integração, no chat. O valor {{agentKey}} é a variável da coleção Postman: troque pela chave ao testar no Swagger."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/chat/channels/:id/messages",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "chat",
                "channels",
                ":id",
                "messages"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Identificador do canal (GET /chat/channels)."
                }
              ]
            },
            "body": {
              "mode": "formdata",
              "formdata": [
                {
                  "key": "text",
                  "value": "@ana@empresa.com.br o pipeline **faturamento-diario** falhou na etapa _exportar_.",
                  "type": "text",
                  "description": "Texto da mensagem, até 12000 caracteres, com a formatação leve do chat: **negrito**, _itálico_, __sublinhado__, ~~tachado~~, [texto](https://…), `código`, bloco de código entre ``` e listas com linhas iniciadas por \"1. \" ou \"- \". Obrigatório quando não há arquivos."
                },
                {
                  "key": "mentions",
                  "value": "ana@empresa.com.br",
                  "type": "text",
                  "description": "E-mails das pessoas a mencionar, até 100. Viram menção os membros do canal; cada e-mail não mencionado volta em notMentioned. Escreva @email no texto para indicar onde a menção aparece. Em multipart/form-data, repita o campo (um e-mail por campo) ou envie uma lista JSON."
                },
                {
                  "key": "thread",
                  "value": "",
                  "type": "text",
                  "description": "Identificador de uma mensagem anterior do mesmo canal: a mensagem é publicada como resposta na conversa (thread) dela.",
                  "disabled": true
                },
                {
                  "key": "clientId",
                  "value": "faturamento-diario-2026-11-21",
                  "type": "text",
                  "description": "Chave do envio, gerada pela integração, até 100 caracteres. Repetir o mesmo clientId com o mesmo agente não publica de novo: a resposta (200) traz a mensagem publicada da primeira vez. Use-a em toda nova tentativa."
                },
                {
                  "key": "files",
                  "type": "file",
                  "src": [],
                  "description": "Somente em multipart/form-data: até 5 arquivos de até 10 MB cada. Arquivos executáveis (.exe, .bat, .sh, .cmd, .msi, .com, .scr) são recusados."
                }
              ]
            },
            "description": "Publica uma mensagem em nome do agente em um canal público e não arquivado da empresa, sem que o agente seja membro do canal. Os membros recebem a mensagem como a de uma pessoa: em tempo real, com contador de não lidas, alertas e push para quem foi mencionado. Envie JSON ou, com arquivos, multipart/form-data: até 5 arquivos de até 10 MB cada, no campo files, e os demais campos como campos do formulário. Arquivos executáveis são recusados. O texto aceita a formatação leve do chat, até 12000 caracteres. Para mencionar, liste os e-mails em mentions: viram menção os membros do canal, e cada e-mail não mencionado volta em notMentioned, com o motivo. Escreva @email no texto para indicar onde a menção aparece; o chat mostra o nome da pessoa. thread publica a mensagem como resposta na conversa de uma mensagem anterior do mesmo canal. clientId identifica o envio: repetir o mesmo clientId não publica de novo e devolve, com status 200, a mensagem publicada da primeira vez. Cada agente pode publicar até 60 mensagens por minuto."
          }
        },
        {
          "name": "Exclui uma mensagem publicada pelo agente",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "X-Agent-Key",
                "value": "{{agentKey}}",
                "description": "Chave do agente de integração (tmca_…), copiada por um administrador em Agentes de integração, no chat. O valor {{agentKey}} é a variável da coleção Postman: troque pela chave ao testar no Swagger."
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/chat/messages/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "chat",
                "messages",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Identificador do item (items[].id da resposta da publicação)."
                }
              ]
            },
            "description": "Exclui, para todos os membros, um item que o próprio agente publicou, como quando uma pessoa exclui a própria mensagem. Uma mensagem com texto e arquivos tem um item para cada um (items da resposta da publicação): cada item é excluído pelo seu identificador. Mensagens de outro agente ou de pessoas são recusadas."
          }
        }
      ]
    }
  ],
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{bearerToken}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://apis.trendmulti.com.br",
      "description": "Endereço da API.",
      "type": "string"
    },
    {
      "key": "channelUuid",
      "value": "",
      "description": "UUID das credenciais de API de um canal de atendimento conectado (no Trendmulti: Canais › o canal › API). Usado em POST /api/auth.",
      "type": "string"
    },
    {
      "key": "channelToken",
      "value": "",
      "description": "Token das credenciais de API do mesmo canal. Usado em POST /api/auth.",
      "type": "string"
    },
    {
      "key": "bearerToken",
      "value": "",
      "description": "Token de acesso. Preenchido sozinho quando POST /api/auth responde; vale por 1 dia.",
      "type": "string"
    },
    {
      "key": "agentKey",
      "value": "",
      "description": "Chave do agente de integração (tmca_…), exigida nas rotas /chat. Os administradores da empresa a copiam em Agentes de integração, no chat.",
      "type": "string"
    }
  ]
}
