{"openapi":"3.1.0","info":{"title":"JuriChat API — Documentação para Integradores","description":"","version":"1.0.0"},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-jurichat-api-key","description":"Chave de API do escritório (criada no painel). Envie o valor no header x-jurichat-api-key."}},"schemas":{}},"paths":{"/office/{id}":{"get":{"summary":"Obter escritório","tags":["Office"],"description":"Retorna os dados do escritório pelo ID, incluindo saldo de créditos por módulo.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"Identificador do recurso."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do escritório."},"name":{"type":"string","description":"Nome do escritório."},"email":{"type":"string","format":"email","description":"E-mail de contato do escritório."},"phoneNumber":{"type":"string","nullable":true,"description":"Telefone do escritório. Null se não informado."},"isArchived":{"type":"boolean","nullable":true,"description":"Indica se o escritório está arquivado."},"archivedAt":{"type":"string","format":"date-time","nullable":true,"description":"Data e hora em que o escritório foi arquivado. Null se não arquivado."},"inOnboarding":{"type":"boolean","description":"Indica se o escritório está no fluxo de onboarding."},"allowProcessLookupByTypedDocument":{"type":"boolean","description":"Indica se o escritório autorizou consultar processos por um CPF/CNPJ digitado pelo cliente no chat. Falso (padrão) significa que a consulta só acontece pelo número do processo ou pelo documento já cadastrado pelo escritório no contato."},"practiceAreas":{"type":"array","items":{"type":"string"},"description":"Áreas de atuação do escritório (J3)."},"sizeBand":{"type":"string","nullable":true,"description":"Porte do escritório. Null se não informado."},"stateUf":{"type":"string","nullable":true,"description":"UF do escritório. Null se não informada."},"timezone":{"type":"string","description":"Fuso do escritório, derivado da UF."},"onboardingVersion":{"type":"integer","nullable":true,"description":"Versão do onboarding: null = legado, 2 = onboarding novo."},"officeCredits":{"type":"array","items":{"anyOf":[{"not":{}},{"type":"object","properties":{"id":{"type":"string","description":"ID do crédito."},"name":{"type":"string","description":"Nome do módulo de crédito."},"balance":{"type":"number","description":"Saldo de créditos disponível."},"creditModuleId":{"type":"string","description":"ID do módulo ao qual o crédito pertence."}},"required":["id","name","balance","creditModuleId"],"additionalProperties":false}]},"description":"Créditos disponíveis por módulo no escritório."}},"required":["id","name","email","phoneNumber","isArchived","archivedAt","inOnboarding","allowProcessLookupByTypedDocument","practiceAreas","sizeBand","stateUf","timezone","onboardingVersion","officeCredits"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Atualizar escritório","tags":["Office"],"description":"Atualiza os dados do escritório.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome do escritório."},"email":{"type":"string","format":"email","description":"E-mail de contato do escritório."},"phoneNumber":{"type":"string","description":"Telefone do escritório."},"inOnboarding":{"type":"boolean","description":"Indica se o escritório ainda está no onboarding."},"allowProcessLookupByTypedDocument":{"type":"boolean","description":"Autoriza o atendimento a consultar processos por um CPF/CNPJ digitado pelo cliente no chat. Ligar assume um risco conhecido: a integração confirma que o documento existe no cadastro do escritório, não que pertence a quem está do outro lado da conversa. Desligado (padrão), a consulta só acontece pelo número do processo ou pelo documento já cadastrado pelo escritório no contato. Omitir o campo mantém o valor atual."},"practiceAreas":{"type":"array","items":{"type":"string","enum":["previdenciario","trabalhista","civel-e-consumidor","familia-e-sucessoes","criminal","tributario","varias","outra"]},"minItems":1,"maxItems":8,"description":"Áreas de atuação do escritório."},"sizeBand":{"type":"string","enum":["solo","2-5","6-15","16-50","50+"],"description":"Porte do escritório."},"stateUf":{"type":"string","enum":["AC","AL","AM","AP","BA","CE","DF","ES","GO","MA","MG","MS","MT","PA","PB","PE","PI","PR","RJ","RN","RO","RR","RS","SC","SE","SP","TO"],"description":"UF do escritório. Define o fuso (`timezone`) do escritório."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"Identificador do recurso."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"string"}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/credits/summary":{"get":{"summary":"Buscar resumo de créditos","tags":["Credits"],"description":"Retorna o resumo de créditos de IA e uso/cobrança de armazenamento do agente (MB e estimativa de fatura).","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"aiCredits":{"type":"object","properties":{"planTotal":{"type":"number"},"used":{"type":"number"},"available":{"type":"number"},"lastRechargeAt":{"type":"string","format":"date-time","nullable":true}},"required":["planTotal","used","available","lastRechargeAt"],"additionalProperties":false},"agentStorage":{"type":"object","properties":{"usedMb":{"type":"number"},"estimatedChargeBrl":{"type":"number"},"pendingInvoice":{"type":"object","properties":{"billingId":{"type":"string"},"amount":{"type":"number"},"dueDate":{"type":"string","format":"date-time"},"invoiceUrl":{"type":"string","nullable":true}},"required":["billingId","amount","dueDate","invoiceUrl"],"additionalProperties":false,"nullable":true},"nextCycleOpensAt":{"type":"string","format":"date-time"},"estimatedNextInvoiceDueAt":{"type":"string","format":"date-time"}},"required":["usedMb","estimatedChargeBrl","pendingInvoice"],"additionalProperties":false}},"required":["aiCredits","agentStorage"],"additionalProperties":false}}}}}}},"/user/":{"post":{"summary":"Criar usuário","tags":["Users"],"description":"Cria operador no escritório com papel, senha e vínculo a uma ou mais inboxes. Conflito de e-mail: 409.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Nome completo do usuário."},"email":{"type":"string","format":"email","description":"E-mail de acesso (único no escritório)."},"password":{"type":"string","minLength":6,"description":"Senha de acesso. Mínimo de 6 caracteres."},"contact":{"type":"string","default":"","description":"Telefone ou WhatsApp do usuário. Opcional."},"imageUrl":{"type":"string","description":"URL de avatar. Opcional."},"notificationSound":{"type":"string","default":"tick.mp3","description":"Arquivo de som para notificações. Padrão: `tick.mp3`."},"officeId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do escritório ao qual o usuário pertence."},"roleId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do papel inicial do usuário."},"inboxId":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"minItems":1,"description":"IDs das inboxes às quais o usuário terá acesso."},"departmentIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"nullable":true,"description":"IDs dos departamentos do usuário. `null` ou `[]` deixa o usuário sem departamentos; ausente não altera. Requer permissão `create:user`."},"onlyAssignedConversations":{"type":"boolean","default":false,"description":"Quando verdadeiro, o usuário visualiza apenas conversas atribuídas a ele. Padrão: false."}},"required":["name","email","password","officeId","roleId","inboxId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do usuário criado."},"name":{"type":"string","description":"Nome do usuário."},"email":{"type":"string","description":"E-mail de acesso."},"contact":{"type":"string","description":"Telefone ou WhatsApp cadastrado."},"imageUrl":{"type":"string","nullable":true,"description":"URL de avatar. Null se não definido."},"notificationSound":{"type":"string","description":"Arquivo de som de notificação."},"officeId":{"type":"string","description":"ID do escritório ao qual o usuário pertence."},"roleId":{"type":"string","description":"ID do papel atribuído ao usuário."},"inboxes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da inbox."},"name":{"type":"string","description":"Nome da inbox."}},"required":["id","name"],"additionalProperties":false},"description":"Inboxes associadas ao usuário no momento da criação."},"departments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do departamento."},"name":{"type":"string","description":"Nome do departamento."}},"required":["id","name"],"additionalProperties":false},"description":"Departamentos associados ao usuário no momento da criação."},"lastInboxUsed":{"type":"string","nullable":true,"description":"ID da última inbox utilizada. Null se não houver."},"onlyAssignedConversations":{"type":"boolean","description":"Indica se o usuário visualiza apenas conversas atribuídas a ele."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."}},"required":["id","name","email","contact","imageUrl","notificationSound","officeId","roleId","inboxes","departments","lastInboxUsed","onlyAssignedConversations","createdAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"get":{"summary":"Listar usuários","tags":["Users"],"description":"Lista todos os usuários do escritório do solicitante, com busca por nome ou e-mail e filtro por papel. Informe `inboxId` para filtrar por uma inbox (workspace) específica. Use `page` e `limit` para paginar.","parameters":[{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"page","required":false,"description":"Número da página."},{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"limit","required":false,"description":"Quantidade de itens por página."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"inboxId","required":false,"description":"ID da inbox (workspace). Filtro opcional: quando informado, lista apenas usuários vinculados a essa inbox."},{"schema":{"type":"string"},"in":"query","name":"search","required":false,"description":"Busca por nome ou e-mail (correspondência parcial)."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"roleId","required":false,"description":"Filtra usuários pelo ID do papel (role)."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do usuário."},"name":{"type":"string","description":"Nome do usuário."},"email":{"type":"string","description":"E-mail de acesso."},"departments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do departamento."},"name":{"type":"string","description":"Nome do departamento."}},"required":["id","name"],"additionalProperties":false},"description":"Departamentos vinculados ao usuário."},"contact":{"type":"string","description":"Telefone ou WhatsApp cadastrado."},"imageUrl":{"type":"string","nullable":true,"description":"URL de avatar. Null se não definido."},"notificationSound":{"type":"string","description":"Arquivo de som de notificação."},"officeId":{"type":"string","description":"ID do escritório ao qual o usuário pertence."},"roleId":{"type":"string","description":"ID do papel atribuído ao usuário."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"role":{"type":"object","properties":{"id":{"type":"string","description":"ID do papel."},"name":{"type":"string","description":"Nome do papel."}},"required":["id","name"],"additionalProperties":false,"description":"Papel atribuído ao usuário."},"office":{"type":"object","properties":{"id":{"type":"string","description":"ID do escritório."},"name":{"type":"string","description":"Nome do escritório."}},"required":["id","name"],"additionalProperties":false,"description":"Escritório ao qual o usuário pertence."},"inboxes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da inbox."},"name":{"type":"string","description":"Nome da inbox."}},"required":["id","name"],"additionalProperties":false},"nullable":true,"description":"Inboxes vinculadas ao usuário. Null se não houver."},"lastInboxUsed":{"type":"string","nullable":true,"description":"ID da última inbox utilizada. Null se não houver."},"onlyAssignedConversations":{"type":"boolean","description":"Quando verdadeiro, o usuário visualiza apenas conversas atribuídas a ele."},"serviceHours":{"nullable":true,"description":"Horário de atendimento: `{ monday: { enabled, intervals: [{ startTime, endTime }] }, ... }` no fuso do escritório. Null = qualquer horário."},"userCanEdit":{"type":"boolean","description":"Indica se o solicitante pode editar este usuário. Gestor pode editar todos; não-gestor não pode editar usuários Gestores."},"hasGoogleLinked":{"type":"boolean","description":"Possui conta Google vinculada."},"googleEmail":{"type":"string","nullable":true,"description":"E-mail da conta Google vinculada. Null se não houver."},"hasPassword":{"type":"boolean","description":"Possui senha cadastrada."}},"required":["id","name","email","departments","contact","imageUrl","notificationSound","officeId","roleId","createdAt","role","office","inboxes","lastInboxUsed","onlyAssignedConversations","userCanEdit","hasGoogleLinked","googleEmail","hasPassword"],"additionalProperties":false},"description":"Usuários da página atual."},"totalResults":{"type":"number","description":"Total de registros encontrados."},"totalPages":{"type":"number","description":"Total de páginas para a quantidade solicitada."}},"required":["data","totalResults","totalPages"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/user/crm-card-config":{"get":{"summary":"Obter configuração dos cards do CRM","tags":["CRM"],"description":"Retorna os campos exibidos nos cards do CRM para o usuário autenticado.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"fields":{"type":"object","properties":{"channel":{"type":"boolean"},"legalArea":{"type":"boolean"},"email":{"type":"boolean"},"phone":{"type":"boolean"},"responsible":{"type":"boolean"},"timeInColumn":{"type":"boolean"},"tags":{"type":"boolean"},"customFields":{"type":"object","additionalProperties":{"type":"boolean"}}},"additionalProperties":false}},"required":["fields"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"put":{"summary":"Atualizar configuração dos cards do CRM","tags":["CRM"],"description":"Salva os campos exibidos nos cards do CRM para o usuário autenticado.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"fields":{"type":"object","properties":{"channel":{"type":"boolean"},"legalArea":{"type":"boolean"},"email":{"type":"boolean"},"phone":{"type":"boolean"},"responsible":{"type":"boolean"},"timeInColumn":{"type":"boolean"},"tags":{"type":"boolean"},"customFields":{"type":"object","additionalProperties":{"type":"boolean"}}},"additionalProperties":false}},"required":["fields"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"fields":{"type":"object","properties":{"channel":{"type":"boolean"},"legalArea":{"type":"boolean"},"email":{"type":"boolean"},"phone":{"type":"boolean"},"responsible":{"type":"boolean"},"timeInColumn":{"type":"boolean"},"tags":{"type":"boolean"},"customFields":{"type":"object","additionalProperties":{"type":"boolean"}}},"additionalProperties":false}},"required":["fields"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/user/{id}":{"get":{"summary":"Obter usuário","tags":["Users"],"description":"Retorna os dados de um usuário pelo ID, incluindo papel, escritório, inboxes e permissões ativas.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do usuário."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do usuário."},"name":{"type":"string","description":"Nome do usuário."},"departments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do departamento."},"name":{"type":"string","description":"Nome do departamento."}},"required":["id","name"],"additionalProperties":false},"description":"Departamentos vinculados ao usuário."},"email":{"type":"string","description":"E-mail de acesso."},"contact":{"type":"string","description":"Telefone ou WhatsApp cadastrado."},"imageUrl":{"type":"string","nullable":true,"description":"URL de avatar. Null se não definido."},"notificationSound":{"type":"string","description":"Arquivo de som de notificação."},"officeId":{"type":"string","description":"ID do escritório ao qual o usuário pertence."},"roleId":{"type":"string","description":"ID do papel atribuído ao usuário."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"role":{"type":"object","properties":{"id":{"type":"string","description":"ID do papel."},"name":{"type":"string","description":"Nome do papel."}},"required":["id","name"],"additionalProperties":false},"office":{"type":"object","properties":{"id":{"type":"string","description":"ID do escritório."},"name":{"type":"string","description":"Nome do escritório."}},"required":["id","name"],"additionalProperties":false},"inboxes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da inbox."},"name":{"type":"string","description":"Nome da inbox."}},"required":["id","name"],"additionalProperties":false},"nullable":true,"description":"Inboxes vinculadas ao usuário. Null se não houver."},"lastInboxUsed":{"type":"string","nullable":true,"description":"ID da última inbox utilizada. Null se não houver."},"onlyAssignedConversations":{"type":"boolean","description":"Quando verdadeiro, o usuário visualiza apenas conversas atribuídas a ele."},"hasGoogleLinked":{"type":"boolean","description":"Possui conta Google vinculada."},"googleEmail":{"type":"string","nullable":true,"description":"E-mail da conta Google vinculada. Null se não houver."},"hasPassword":{"type":"boolean","description":"Possui senha cadastrada."},"emailVerifiedAt":{"type":"string","format":"date-time","nullable":true,"description":"Data da confirmação do e-mail. Null enquanto não confirmado."},"inOnboarding":{"type":"boolean","description":"Indica se o usuário está no fluxo de onboarding."},"permissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da permissão."},"name":{"type":"string","description":"Nome da permissão."},"code":{"type":"string","description":"Código identificador da permissão."}},"required":["id","name","code"],"additionalProperties":false},"description":"Permissões ativas do usuário."}},"required":["id","name","departments","email","contact","imageUrl","notificationSound","officeId","roleId","createdAt","role","office","inboxes","lastInboxUsed","onlyAssignedConversations","hasGoogleLinked","googleEmail","hasPassword","emailVerifiedAt","inOnboarding","permissions"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Atualizar usuário","tags":["Users"],"description":"Atualização parcial: apenas os campos enviados são modificados. Enviar `inboxId` substitui as inboxes do usuário.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"inboxId":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs das inboxes. Quando enviado, substitui as inboxes atuais do usuário."},"departmentIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"nullable":true,"description":"IDs dos departamentos do usuário. `null` ou `[]` remove todos os departamentos; ausente não altera. Requer permissão `edit:user`."},"name":{"type":"string","minLength":1,"description":"Novo nome do usuário."},"email":{"type":"string","format":"email","description":"Novo e-mail de acesso."},"password":{"type":"string","minLength":6,"description":"Nova senha de acesso. Mínimo de 6 caracteres."},"contact":{"type":"string","description":"Novo telefone ou WhatsApp. Opcional."},"imageUrl":{"type":"string","description":"Nova URL de avatar."},"notificationSound":{"type":"string","description":"Novo arquivo de som de notificação."},"roleId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do novo papel do usuário."},"onlyAssignedConversations":{"type":"boolean","description":"Quando verdadeiro, o usuário visualiza apenas conversas atribuídas a ele."},"serviceHours":{"type":"object","properties":{"monday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"tuesday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"wednesday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"thursday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"friday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"saturday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"sunday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false}},"additionalProperties":false,"nullable":true,"description":"Horário de atendimento, no fuso do escritório: `{ monday: { enabled, intervals: [{ startTime, endTime }] }, ... }` (até 4 intervalos por dia; dia ausente = sem atendimento). `null` = qualquer horário. Requer permissão `edit:service-hours`."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do usuário."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do usuário."},"name":{"type":"string","description":"Nome do usuário."},"email":{"type":"string","description":"E-mail de acesso."},"contact":{"type":"string","description":"Telefone ou WhatsApp cadastrado."},"imageUrl":{"type":"string","nullable":true,"description":"URL de avatar. Null se não definido."},"notificationSound":{"type":"string","description":"Arquivo de som de notificação."},"officeId":{"type":"string","description":"ID do escritório ao qual o usuário pertence."},"roleId":{"type":"string","description":"ID do papel atribuído ao usuário."},"inboxes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da inbox."},"name":{"type":"string","description":"Nome da inbox."}},"required":["id","name"],"additionalProperties":false},"description":"Inboxes vinculadas após a atualização."},"departments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do departamento."},"name":{"type":"string","description":"Nome do departamento."}},"required":["id","name"],"additionalProperties":false},"description":"Departamentos vinculados após a atualização."},"lastInboxUsed":{"type":"string","description":"ID da última inbox utilizada."},"onlyAssignedConversations":{"type":"boolean","description":"Indica se o usuário visualiza apenas conversas atribuídas a ele."},"serviceHours":{"nullable":true,"description":"Horário de atendimento. Null = qualquer horário."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação original do usuário."}},"required":["id","name","email","contact","imageUrl","notificationSound","officeId","roleId","inboxes","departments","lastInboxUsed","onlyAssignedConversations","createdAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir usuário","tags":["Users"],"description":"Remove permanentemente o usuário. Pode afetar dados vinculados como conversas e inboxes.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do usuário a ser removido."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Mensagem de confirmação da operação."}},"required":["message"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/user/{id}/avatar":{"post":{"summary":"Enviar foto de perfil do usuário","tags":["Users"],"description":"Recebe a imagem em multipart (campo `file`), aceita JPG, PNG ou WEBP de até 10MB e substitui a foto anterior. O próprio usuário pode alterar a sua; alterar a de outro exige perfil Gestor ou a permissão `view:teams`.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do usuário."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"imageUrl":{"type":"string","nullable":true,"description":"URL assinada da foto de perfil. Null quando não há foto."}},"required":["imageUrl"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Remover foto de perfil do usuário","tags":["Users"],"description":"Zera a foto de perfil e apaga o arquivo do storage. Idempotente: usuário sem foto responde 200.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do usuário."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"imageUrl":{"type":"string","nullable":true,"description":"URL assinada da foto de perfil. Null quando não há foto."}},"required":["imageUrl"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/user-roles/":{"post":{"summary":"Criar papel","tags":["Roles"],"description":"Cria um novo papel.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome do papel."},"permissions":{"type":"array","items":{"type":"string"},"description":"Lista de permissões atribuídas ao papel."}},"required":["name"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do papel."},"name":{"type":"string","description":"Nome do papel."},"permissions":{"type":"array","items":{"type":"string"},"description":"Permissões do papel."}},"required":["id","name"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"get":{"summary":"Listar papéis","tags":["Roles"],"description":"Lista os papéis do escritório.","parameters":[{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"page","required":false,"description":"Página da listagem."},{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"limit","required":false,"description":"Quantidade de itens por página."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do papel."},"name":{"type":"string","description":"Nome do papel."},"permissions":{"type":"array","items":{"type":"string"},"description":"Permissões do papel."}},"required":["id","name"],"additionalProperties":false}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/user-roles/{id}":{"get":{"summary":"Obter papel","tags":["Roles"],"description":"Retorna um papel pelo ID.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do papel."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do papel."},"name":{"type":"string","description":"Nome do papel."},"permissions":{"type":"array","items":{"type":"string"},"description":"Permissões do papel."}},"required":["id","name"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"put":{"summary":"Atualizar papel","tags":["Roles"],"description":"Atualiza um papel existente.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Novo nome do papel."},"permissions":{"type":"array","items":{"type":"string"},"description":"Lista de permissões do papel."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do papel."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"permissions":{"type":"array","items":{"type":"string"}}},"required":["id","name"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir papel","tags":["Roles"],"description":"Remove um papel pelo ID.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do papel."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/user-roles/permissions":{"get":{"summary":"Listar permissões","tags":["Roles"],"description":"Lista todas as permissões disponíveis.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da permissão."},"name":{"type":"string","description":"Nome da permissão."},"code":{"type":"string","description":"Código da permissão."}},"required":["id","name","code"],"additionalProperties":false}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/inbox/":{"post":{"summary":"Criar inbox","tags":["Inboxes"],"description":"Cria uma nova caixa de entrada","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255,"description":"Nome da inbox."},"officeId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do escritório ao qual a inbox pertence."}},"required":["name","officeId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID da inbox."},"name":{"type":"string","description":"Nome da inbox."},"officeId":{"type":"string","description":"ID do escritório."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","officeId","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"get":{"summary":"Listar inboxes","tags":["Inboxes"],"description":"Lista todas as inboxes do escritório. Filtros opcionais por nome e integração.","parameters":[{"schema":{"type":"string"},"in":"query","name":"name","required":false,"description":"Filtra por nome da inbox (correspondência parcial)."},{"schema":{"type":"string"},"in":"query","name":"integrationId","required":false,"description":"Filtra pelo ID da integração vinculada à inbox."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da inbox."},"name":{"type":"string","description":"Nome da inbox."},"officeId":{"type":"string","description":"ID do escritório ao qual a inbox pertence."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","officeId","createdAt","updatedAt"],"additionalProperties":false}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/inbox/{id}":{"get":{"summary":"Obter inbox","tags":["Inboxes"],"description":"Retorna os dados de uma inbox pelo ID.","parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true,"description":"ID da inbox."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID da inbox."},"name":{"type":"string","description":"Nome da inbox."},"officeId":{"type":"string","description":"ID do escritório ao qual a inbox pertence."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","officeId","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"put":{"summary":"Atualizar inbox","tags":["Inboxes"],"description":"Atualiza uma caixa de entrada existente","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255,"description":"Novo nome da inbox."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true,"description":"ID da inbox."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID da inbox."},"name":{"type":"string","description":"Nome da inbox."},"officeId":{"type":"string","description":"ID do escritório."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","officeId","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir inbox","tags":["Inboxes"],"description":"Remove uma caixa de entrada existente","parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true,"description":"ID da inbox."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"],"nullable":true}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/juridiq/contacts/{contactId}/link":{"get":{"summary":"Consultar vínculo do contato com o Juridiq","tags":["Integration"],"description":"Retorna a pessoa do Juridiq vinculada ao contato do Jurichat, quando existe. Exige integração com o Juridiq ativa no escritório (409 quando inativa).","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"contactId","required":true,"description":"ID do contato no Jurichat (Person.id)."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"linked":{"type":"boolean","description":"Verdadeiro quando o contato tem pessoa vinculada."},"linkId":{"type":"string","nullable":true,"description":"ID do vínculo. Use no DELETE para desvincular."},"person":{"type":"object","properties":{"id":{"type":"string","description":"ID da pessoa no Juridiq."},"name":{"type":"string","description":"Nome da pessoa no Juridiq."},"document":{"type":"string","nullable":true,"description":"CPF ou CNPJ, quando cadastrado."},"phone":{"type":"string","nullable":true,"description":"Telefone, quando cadastrado."}},"required":["id","name"],"additionalProperties":false,"nullable":true,"description":"Pessoa vinculada, ou null."},"linkedAt":{"type":"string","nullable":true,"description":"Data da criação do vínculo (ISO 8601)."},"source":{"type":"string","nullable":true,"description":"Origem do vínculo: MANUAL, BUTTON, CRM ou backfill."}},"required":["linked"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Vincular contato do Jurichat a pessoa do Juridiq","tags":["Integration"],"description":"Cria o vínculo entre o contato do Jurichat e a pessoa do Juridiq, com origem `MANUAL`. Um contato tem no máximo uma pessoa por integração: repetir o mesmo par é idempotente, trocar por outra pessoa retorna 409 — desvincule antes. Exige `edit:customer` e acesso do usuário à inbox do contato.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"personId":{"type":"string","format":"uuid","description":"ID da pessoa no Juridiq, obtido na busca de pessoas."}},"required":["personId"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"contactId","required":true,"description":"ID do contato no Jurichat (Person.id)."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"linked":{"type":"boolean","description":"Verdadeiro quando o contato tem pessoa vinculada."},"linkId":{"type":"string","nullable":true,"description":"ID do vínculo. Use no DELETE para desvincular."},"person":{"type":"object","properties":{"id":{"type":"string","description":"ID da pessoa no Juridiq."},"name":{"type":"string","description":"Nome da pessoa no Juridiq."},"document":{"type":"string","nullable":true,"description":"CPF ou CNPJ, quando cadastrado."},"phone":{"type":"string","nullable":true,"description":"Telefone, quando cadastrado."}},"required":["id","name"],"additionalProperties":false,"nullable":true,"description":"Pessoa vinculada, ou null."},"linkedAt":{"type":"string","nullable":true,"description":"Data da criação do vínculo (ISO 8601)."},"source":{"type":"string","nullable":true,"description":"Origem do vínculo: MANUAL, BUTTON, CRM ou backfill."}},"required":["linked"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/juridiq/contacts/{contactId}/persons":{"get":{"summary":"Buscar pessoas no Juridiq para vincular ao contato","tags":["Integration"],"description":"Busca pessoas (fichas de cliente) no Juridiq por nome, CPF/CNPJ ou telefone. É de onde sai o `personId` usado para criar o vínculo. Paginação por cursor.","parameters":[{"schema":{"type":"string","minLength":2,"maxLength":120},"in":"query","name":"query","required":true,"description":"Nome, CPF/CNPJ ou telefone da pessoa no Juridiq."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"cursor","required":false,"description":"Cursor da página seguinte, devolvido em `nextCursor`."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"contactId","required":true,"description":"ID do contato no Jurichat (Person.id)."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"persons":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da pessoa no Juridiq."},"name":{"type":"string","description":"Nome da pessoa no Juridiq."},"document":{"type":"string","nullable":true,"description":"CPF ou CNPJ, quando cadastrado."},"phone":{"type":"string","nullable":true,"description":"Telefone, quando cadastrado."}},"required":["id","name"],"additionalProperties":false},"description":"Pessoas encontradas no Juridiq."},"nextCursor":{"type":"string","nullable":true,"description":"Cursor da próxima página, ou null quando não há mais resultados."}},"required":["persons"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/juridiq/contacts/{contactId}/link/{linkId}":{"delete":{"summary":"Desvincular contato do Jurichat da pessoa do Juridiq","tags":["Integration"],"description":"Remove apenas o vínculo identificado por `linkId`. Os dois cadastros e os arquivos já enviados são preservados. Exige `edit:customer`.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"contactId","required":true,"description":"ID do contato no Jurichat (Person.id)."},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"linkId","required":true,"description":"ID do vínculo a remover, devolvido no GET do vínculo."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"linked":{"type":"boolean","description":"Verdadeiro quando o contato tem pessoa vinculada."},"linkId":{"type":"string","nullable":true,"description":"ID do vínculo. Use no DELETE para desvincular."},"person":{"type":"object","properties":{"id":{"type":"string","description":"ID da pessoa no Juridiq."},"name":{"type":"string","description":"Nome da pessoa no Juridiq."},"document":{"type":"string","nullable":true,"description":"CPF ou CNPJ, quando cadastrado."},"phone":{"type":"string","nullable":true,"description":"Telefone, quando cadastrado."}},"required":["id","name"],"additionalProperties":false,"nullable":true,"description":"Pessoa vinculada, ou null."},"linkedAt":{"type":"string","nullable":true,"description":"Data da criação do vínculo (ISO 8601)."},"source":{"type":"string","nullable":true,"description":"Origem do vínculo: MANUAL, BUTTON, CRM ou backfill."}},"required":["linked"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/juridiq/task-boards":{"get":{"summary":"Listar pastas, quadros e colunas de tarefas do Juridiq","tags":["Integration"],"description":"Árvore ativa de tarefas do Juridiq do escritório. O `id` da coluna é o `columnId` da ação CREATE_JURIDIQ_TASK das automações. Exige integração com o Juridiq ativa (409 quando inativa).","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"folders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da pasta no Juridiq."},"name":{"type":"string","description":"Nome da pasta."},"boards":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do quadro no Juridiq."},"name":{"type":"string","description":"Nome do quadro."},"columns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da coluna: é o `columnId` da ação CREATE_JURIDIQ_TASK."},"name":{"type":"string","description":"Nome da coluna."}},"required":["id","name"],"additionalProperties":false},"description":"Colunas do quadro, na ordem do Juridiq."}},"required":["id","name","columns"],"additionalProperties":false},"description":"Quadros ativos da pasta."}},"required":["id","name","boards"],"additionalProperties":false},"description":"Pastas ativas. Quem não é Gestor no Juridiq vê só onde é responsável."}},"required":["folders"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/":{"get":{"summary":"Listar integrações","tags":["Integration"],"description":"Lista as integrações de uma inbox. Filtro opcional por canal.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"inboxId","required":true},{"schema":{"type":"string","enum":["WHATSAPP","WEB_CHAT","TELEGRAM","INSTAGRAM","LITE_WHATSAPP","JURIDIQ"]},"in":"query","name":"channel","required":false}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"channel":{"type":"string","enum":["WHATSAPP","WEB_CHAT","TELEGRAM","INSTAGRAM","LITE_WHATSAPP","JURIDIQ"]},"config":{"type":"object","properties":{"status":{"type":"string","enum":["disconnected","connected","connecting"]},"token":{"type":"string"},"iceBreakers":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"payload":{"type":"string"}},"required":["question","payload"],"additionalProperties":false}},"createConversationFromComments":{"type":"boolean"}},"required":["status"],"additionalProperties":false},"flowId":{"type":"string","nullable":true},"funnelId":{"type":"string","nullable":true},"agentId":{"type":"string","nullable":true},"inboxId":{"type":"string"},"officeId":{"type":"string"},"connectedAt":{"type":"string","format":"date-time","nullable":true},"aiAudience":{"type":"string","enum":["new_contacts","all","nobody"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","channel","config","flowId","funnelId","agentId","inboxId","officeId","connectedAt","aiAudience","createdAt","updatedAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/{integrationId}":{"get":{"summary":"Obter integração","tags":["Integration"],"description":"Retorna os dados de uma integração pelo ID. O `inboxId` é obrigatório para garantir que a integração pertence à inbox informada.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox. Obrigatório para garantir que a integração pertence à inbox."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"integrationId","required":true,"description":"ID da integração."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"channel":{"type":"string","enum":["WHATSAPP","WEB_CHAT","TELEGRAM","INSTAGRAM","LITE_WHATSAPP","JURIDIQ"]},"config":{"type":"object","properties":{"status":{"type":"string","enum":["disconnected","connected","connecting"]},"token":{"type":"string"},"iceBreakers":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"payload":{"type":"string"}},"required":["question","payload"],"additionalProperties":false}},"createConversationFromComments":{"type":"boolean"}},"required":["status"],"additionalProperties":false},"flowId":{"type":"string","nullable":true},"funnelId":{"type":"string","nullable":true},"agentId":{"type":"string","nullable":true},"inboxId":{"type":"string"},"officeId":{"type":"string"},"connectedAt":{"type":"string","format":"date-time","nullable":true},"aiAudience":{"type":"string","enum":["new_contacts","all","nobody"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","channel","config","flowId","funnelId","agentId","inboxId","officeId","connectedAt","aiAudience","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Update integration","tags":["Integration"],"description":"Update integration","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"flowId":{"type":"string","nullable":true},"funnelId":{"type":"string","nullable":true},"agentId":{"type":"string","nullable":true},"instagramSettings":{"type":"object","properties":{"iceBreakers":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string","minLength":1,"maxLength":80},"payload":{"type":"string","minLength":1,"maxLength":1000}},"required":["question","payload"],"additionalProperties":false},"maxItems":4},"commentAutomations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64},"keyword":{"type":"string","minLength":1,"maxLength":80},"match":{"type":"string","enum":["contains","exact"],"default":"contains"},"scope":{"type":"string","enum":["all_posts","selected_posts"],"default":"all_posts"},"postIds":{"type":"array","items":{"type":"string","minLength":1},"maxItems":20,"default":[]},"privateReplyText":{"type":"string","minLength":1,"maxLength":1000},"publicReplyText":{"type":"string","maxLength":500},"enabled":{"type":"boolean","default":true}},"required":["id","keyword","privateReplyText"],"additionalProperties":false},"maxItems":20},"storyMentionReply":{"type":"object","properties":{"enabled":{"type":"boolean"},"message":{"type":"string","minLength":1,"maxLength":1000}},"required":["enabled","message"],"additionalProperties":false,"nullable":true},"createConversationFromComments":{"type":"boolean","description":"Quando true, todo comentário abre conversa no JuriChat. Default false. Uma automação Então pode passar por cima."}},"additionalProperties":false}},"additionalProperties":false}}}},"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string"},"in":"path","name":"integrationId","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"channel":{"type":"string","enum":["WHATSAPP","WEB_CHAT","TELEGRAM","INSTAGRAM","LITE_WHATSAPP","JURIDIQ"]},"config":{"type":"object","properties":{"status":{"type":"string","enum":["disconnected","connected","connecting"]},"token":{"type":"string"},"iceBreakers":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"payload":{"type":"string"}},"required":["question","payload"],"additionalProperties":false}},"createConversationFromComments":{"type":"boolean"}},"required":["status"],"additionalProperties":false},"flowId":{"type":"string","nullable":true},"funnelId":{"type":"string","nullable":true},"agentId":{"type":"string","nullable":true},"inboxId":{"type":"string"},"officeId":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","channel","config","flowId","funnelId","agentId","inboxId","officeId","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Delete integration","tags":["Integration"],"description":"Delete integration","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"integrationId","required":true}],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"string"}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/whatsapp-devices":{"get":{"summary":"Listar aparelhos de WhatsApp do escritório","tags":["Integration"],"description":"Lista as conexões LITE_WHATSAPP do escritório, incluindo as desconectadas. Usado pelo Juridiq para escolher por qual aparelho os lembretes de audiência saem. Com `includeOfficial=true`, inclui também as conexões WhatsApp Oficial (`channel: WHATSAPP`), que exigem template aprovado no envio.","parameters":[{"schema":{"type":"string","enum":["true"]},"in":"query","name":"includeOfficial","required":false}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"devices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"channel":{"type":"string","enum":["LITE_WHATSAPP","WHATSAPP"]},"inboxId":{"type":"string"},"inboxName":{"type":"string","nullable":true},"status":{"type":"string","enum":["disconnected","connected","connecting"]},"isDefault":{"type":"boolean"}},"required":["id","name","channel","inboxId","inboxName","status","isDefault"],"additionalProperties":false}}},"required":["devices"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/juridiq/whatsapp-templates":{"get":{"summary":"Listar templates WhatsApp Oficial do aparelho","tags":["Integration"],"description":"Lista templates APPROVED (por padrão) da integração WhatsApp Oficial indicada por `deviceId`. Escopo pelo escritório do portador da API key.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"deviceId","required":true},{"schema":{"anyOf":[{"type":"string","enum":["APPROVED","PENDING","REJECTED","PAUSED"],"description":"Status de aprovação do template na Meta. Apenas templates APPROVED podem ser enviados."},{"type":"array","items":{"type":"string","enum":["APPROVED","PENDING","REJECTED","PAUSED"],"description":"Status de aprovação do template na Meta. Apenas templates APPROVED podem ser enviados."}}]},"in":"query","name":"status","required":false}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nome do template na Meta, em letras minúsculas."},"status":{"anyOf":[{"type":"string","enum":["APPROVED","PENDING","REJECTED","PAUSED"],"description":"Status de aprovação do template na Meta. Apenas templates APPROVED podem ser enviados."},{"type":"string"}],"description":"Status de aprovação do template na Meta."},"category":{"type":"string","description":"Categoria do template: UTILITY, MARKETING ou AUTHENTICATION."},"language":{"type":"string","description":"Código do idioma do template, ex.: pt_BR."},"components":{"type":"array","items":{"type":"object","additionalProperties":{}},"description":"Componentes do template (HEADER, BODY, FOOTER e BUTTONS)."},"id":{"type":"string","description":"ID do template na Meta. Use-o para atualizar o template."}},"required":["name","status","category","language","components","id"],"additionalProperties":false},"description":"Templates cadastrados na WABA."}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Garantir template WhatsApp Oficial de uma automação do Juridiq","tags":["Integration"],"description":"Find-or-create por nome exato e `pt_BR` no aparelho WhatsApp Oficial indicado. A categoria e o prefixo do nome são impostos pela finalidade (`purpose`). Exige a credencial do Juridiq (`x-jurichat-api-key`) e `x-juridiq-office-id` do vínculo ativo.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"deviceId":{"type":"string","minLength":1},"purpose":{"type":"string","enum":["AUDIENCE_REMINDER","EVENT_REMINDER","BIRTHDAY"]},"name":{"type":"string"},"bodyText":{"type":"string","minLength":1,"maxLength":1024},"examples":{"type":"array","items":{"type":"string","minLength":1,"maxLength":200},"minItems":1,"maxItems":10}},"required":["deviceId","purpose","name","bodyText","examples"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"language":{"type":"string","enum":["pt_BR"]},"status":{"type":"string"},"category":{"type":"string"}},"required":["name","language","status","category"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/juridiq/audience-reminder":{"post":{"summary":"Enviar lembrete de audiência","tags":["Integration"],"description":"Envia um lembrete de audiência pelo aparelho indicado, criando ou reaproveitando o contato e a conversa. No WhatsApp Oficial exige `templateName`. Idempotente por `idempotencyKey`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":8,"maxLength":200},"deviceId":{"type":"string","minLength":1},"phone":{"type":"string","minLength":10,"maxLength":20},"message":{"type":"string","minLength":1,"maxLength":1200},"contactName":{"type":"string","maxLength":120},"reference":{"type":"object","properties":{"audienceId":{"type":"string"},"workflowInstanceId":{"type":"string"},"personId":{"type":"string"}},"required":["personId"],"additionalProperties":false},"templateName":{"type":"string","minLength":1},"variables":{"type":"array","items":{"type":"string"}},"headerVariables":{"type":"array","items":{"type":"string"}},"headerVariableNames":{"type":"array","items":{"type":"string"}},"bodyVariableNames":{"type":"array","items":{"type":"string"}},"buttonVariables":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0},"parameters":{"type":"array","items":{"type":"string"}},"parameterNames":{"type":"array","items":{"type":"string"}}},"required":["index","parameters"],"additionalProperties":false}},"headerMedia":{"type":"object","properties":{"format":{"type":"string","enum":["IMAGE","VIDEO","DOCUMENT","LOCATION"]},"link":{"type":"string"},"filename":{"type":"string"},"latitude":{"anyOf":[{"type":"string"},{"type":"number"}]},"longitude":{"anyOf":[{"type":"string"},{"type":"number"}]},"name":{"type":"string"},"address":{"type":"string"}},"required":["format"],"additionalProperties":false}},"required":["idempotencyKey","deviceId","phone"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["SENT","ALREADY_SENT"]},"externalMessageId":{"type":"string","nullable":true},"conversationId":{"type":"string","nullable":true}},"required":["status","externalMessageId","conversationId"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/juridiq/workflow-message":{"post":{"summary":"Enviar mensagem de automação do Juridiq","tags":["Integration"],"description":"Envia uma mensagem de um passo de automação do Juridiq pelo aparelho indicado, criando ou reaproveitando o contato e a conversa. No WhatsApp Oficial exige `templateName`. Idempotente por `idempotencyKey`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"idempotencyKey":{"type":"string","minLength":8,"maxLength":200},"deviceId":{"type":"string","minLength":1},"phone":{"type":"string","minLength":10,"maxLength":20},"message":{"type":"string","minLength":1,"maxLength":1200},"contactName":{"type":"string","maxLength":120},"reference":{"type":"object","properties":{"audienceId":{"type":"string"},"workflowInstanceId":{"type":"string"},"personId":{"type":"string"}},"required":["personId"],"additionalProperties":false},"templateName":{"type":"string","minLength":1},"variables":{"type":"array","items":{"type":"string"}},"headerVariables":{"type":"array","items":{"type":"string"}},"headerVariableNames":{"type":"array","items":{"type":"string"}},"bodyVariableNames":{"type":"array","items":{"type":"string"}},"buttonVariables":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0},"parameters":{"type":"array","items":{"type":"string"}},"parameterNames":{"type":"array","items":{"type":"string"}}},"required":["index","parameters"],"additionalProperties":false}},"headerMedia":{"type":"object","properties":{"format":{"type":"string","enum":["IMAGE","VIDEO","DOCUMENT","LOCATION"]},"link":{"type":"string"},"filename":{"type":"string"},"latitude":{"anyOf":[{"type":"string"},{"type":"number"}]},"longitude":{"anyOf":[{"type":"string"},{"type":"number"}]},"name":{"type":"string"},"address":{"type":"string"}},"required":["format"],"additionalProperties":false}},"required":["idempotencyKey","deviceId","phone"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["SENT","ALREADY_SENT"]},"externalMessageId":{"type":"string","nullable":true},"conversationId":{"type":"string","nullable":true}},"required":["status","externalMessageId","conversationId"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/google-calendar/auth-url":{"get":{"summary":"Gerar a URL de consentimento do Google Agenda","tags":["GoogleCalendar"],"description":"Devolve a URL para onde o escritório deve ser enviado para autorizar o acesso à agenda. O `state` já vai assinado.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"URL da tela de consentimento do Google."}},"required":["url"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/google-calendar":{"get":{"summary":"Estado da conexão com o Google Agenda","tags":["GoogleCalendar"],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"connected":{"type":"boolean"},"accountEmail":{"type":"string","nullable":true}},"required":["connected","accountEmail"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Desconectar o Google Agenda","tags":["GoogleCalendar"],"description":"Marca a integração como desconectada e **apaga** o refresh token. Não revoga o acesso do lado do Google — isso é feito na conta do usuário.","security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"],"nullable":true}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/connections/google/auth-url":{"get":{"summary":"Gerar a URL de consentimento do Google para a Agenda","tags":["Calendar"],"description":"Devolve a URL para onde o usuário deve ser enviado. O `state` já vai assinado.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"URL da tela de consentimento do Google."}},"required":["url"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/connections":{"get":{"summary":"Listar conexões Google do usuário","tags":["Calendar"],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"accountEmail":{"type":"string"},"status":{"type":"string","enum":["active","reauth_required"]},"createdAt":{"type":"string"},"calendarsCount":{"type":"integer"}},"required":["id","accountEmail","status","createdAt","calendarsCount"],"additionalProperties":false}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/connections/{id}/disconnect-preview":{"get":{"summary":"Prever o que a desconexão vai apagar","tags":["Calendar"],"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID da conexão Google."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"calendarsToRemove":{"type":"integer","description":"Agendas que só esta conexão alimenta."},"linkedEventsToLose":{"type":"integer","description":"Eventos dessas agendas vinculados a conversas ou contatos."}},"required":["calendarsToRemove","linkedEventsToLose"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/connections/{id}":{"delete":{"summary":"Desconectar uma conta Google","tags":["Calendar"],"description":"Revoga o token no Google, apaga a conexão e as agendas que só ela alimentava (com eventos, vínculos e lembretes).","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID da conexão Google."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"],"nullable":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/connections/{id}/reconnect":{"post":{"summary":"Gerar a URL para reconectar uma conta Google","tags":["Calendar"],"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID da conexão Google."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"URL da tela de consentimento do Google."}},"required":["url"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/connections/{id}/refresh-calendars":{"post":{"summary":"Reler a lista de agendas da conexão","tags":["Calendar"],"description":"Gatilho manual do cron diário (útil em desenvolvimento). Devolve as agendas da conexão após a releitura.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID da conexão Google."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"provider":{"type":"string","enum":["internal","google"]},"name":{"type":"string"},"color":{"type":"string"},"effectiveColor":{"type":"string"},"timezone":{"type":"string","nullable":true},"teamSharing":{"type":"string","enum":["none","free_busy","read","write"]},"effectiveRole":{"type":"string","enum":["owner","writer","reader","free_busy","none"]},"isPrimary":{"type":"boolean"},"ownerUserId":{"type":"string","nullable":true},"ownerName":{"type":"string","nullable":true},"ownerImageUrl":{"type":"string","nullable":true},"ownerDepartments":{"type":"array","items":{"type":"string"},"description":"Setores (departamentos) do dono, em ordem alfabética."},"connectionId":{"type":"string","nullable":true},"accountEmail":{"type":"string","nullable":true},"entry":{"type":"object","properties":{"enabled":{"type":"boolean"},"visible":{"type":"boolean"},"color":{"type":"string","nullable":true}},"required":["enabled","visible","color"],"additionalProperties":false,"nullable":true},"sync":{"type":"object","properties":{"status":{"type":"string","enum":["idle","syncing","error"]},"error":{"type":"string","nullable":true},"lastSyncAt":{"type":"string","nullable":true}},"required":["status","error","lastSyncAt"],"additionalProperties":false}},"required":["id","provider","name","color","effectiveColor","timezone","teamSharing","effectiveRole","isPrimary","ownerUserId","ownerName","ownerImageUrl","ownerDepartments","connectionId","accountEmail","entry","sync"],"additionalProperties":false}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/calendars":{"get":{"summary":"Listar agendas","tags":["Calendar"],"description":"Agendas próprias (com entrada do usuário) e compartilhadas pelo escritório, agrupadas por dono. Garante a agenda interna \"Minha agenda\" do usuário.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"own":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"provider":{"type":"string","enum":["internal","google"]},"name":{"type":"string"},"color":{"type":"string"},"effectiveColor":{"type":"string"},"timezone":{"type":"string","nullable":true},"teamSharing":{"type":"string","enum":["none","free_busy","read","write"]},"effectiveRole":{"type":"string","enum":["owner","writer","reader","free_busy","none"]},"isPrimary":{"type":"boolean"},"ownerUserId":{"type":"string","nullable":true},"ownerName":{"type":"string","nullable":true},"ownerImageUrl":{"type":"string","nullable":true},"ownerDepartments":{"type":"array","items":{"type":"string"},"description":"Setores (departamentos) do dono, em ordem alfabética."},"connectionId":{"type":"string","nullable":true},"accountEmail":{"type":"string","nullable":true},"entry":{"type":"object","properties":{"enabled":{"type":"boolean"},"visible":{"type":"boolean"},"color":{"type":"string","nullable":true}},"required":["enabled","visible","color"],"additionalProperties":false,"nullable":true},"sync":{"type":"object","properties":{"status":{"type":"string","enum":["idle","syncing","error"]},"error":{"type":"string","nullable":true},"lastSyncAt":{"type":"string","nullable":true}},"required":["status","error","lastSyncAt"],"additionalProperties":false}},"required":["id","provider","name","color","effectiveColor","timezone","teamSharing","effectiveRole","isPrimary","ownerUserId","ownerName","ownerImageUrl","ownerDepartments","connectionId","accountEmail","entry","sync"],"additionalProperties":false}},"shared":{"type":"array","items":{"type":"object","properties":{"ownerUserId":{"type":"string","nullable":true},"ownerName":{"type":"string","nullable":true},"calendars":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"provider":{"type":"string","enum":["internal","google"]},"name":{"type":"string"},"color":{"type":"string"},"effectiveColor":{"type":"string"},"timezone":{"type":"string","nullable":true},"teamSharing":{"type":"string","enum":["none","free_busy","read","write"]},"effectiveRole":{"type":"string","enum":["owner","writer","reader","free_busy","none"]},"isPrimary":{"type":"boolean"},"ownerUserId":{"type":"string","nullable":true},"ownerName":{"type":"string","nullable":true},"ownerImageUrl":{"type":"string","nullable":true},"ownerDepartments":{"type":"array","items":{"type":"string"},"description":"Setores (departamentos) do dono, em ordem alfabética."},"connectionId":{"type":"string","nullable":true},"accountEmail":{"type":"string","nullable":true},"entry":{"type":"object","properties":{"enabled":{"type":"boolean"},"visible":{"type":"boolean"},"color":{"type":"string","nullable":true}},"required":["enabled","visible","color"],"additionalProperties":false,"nullable":true},"sync":{"type":"object","properties":{"status":{"type":"string","enum":["idle","syncing","error"]},"error":{"type":"string","nullable":true},"lastSyncAt":{"type":"string","nullable":true}},"required":["status","error","lastSyncAt"],"additionalProperties":false}},"required":["id","provider","name","color","effectiveColor","timezone","teamSharing","effectiveRole","isPrimary","ownerUserId","ownerName","ownerImageUrl","ownerDepartments","connectionId","accountEmail","entry","sync"],"additionalProperties":false}}},"required":["ownerUserId","ownerName","calendars"],"additionalProperties":false}}},"required":["own","shared"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/calendars/{id}/entry":{"patch":{"summary":"Atualizar preferências da agenda","tags":["Calendar"],"description":"Habilita/oculta a agenda para o usuário e define a cor pessoal.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Mostrar no Jurichat (sincroniza)."},"visible":{"type":"boolean","description":"Checkbox da sidebar."},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","nullable":true,"description":"Cor só para este usuário."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID da agenda."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"provider":{"type":"string","enum":["internal","google"]},"name":{"type":"string"},"color":{"type":"string"},"effectiveColor":{"type":"string"},"timezone":{"type":"string","nullable":true},"teamSharing":{"type":"string","enum":["none","free_busy","read","write"]},"effectiveRole":{"type":"string","enum":["owner","writer","reader","free_busy","none"]},"isPrimary":{"type":"boolean"},"ownerUserId":{"type":"string","nullable":true},"ownerName":{"type":"string","nullable":true},"ownerImageUrl":{"type":"string","nullable":true},"ownerDepartments":{"type":"array","items":{"type":"string"},"description":"Setores (departamentos) do dono, em ordem alfabética."},"connectionId":{"type":"string","nullable":true},"accountEmail":{"type":"string","nullable":true},"entry":{"type":"object","properties":{"enabled":{"type":"boolean"},"visible":{"type":"boolean"},"color":{"type":"string","nullable":true}},"required":["enabled","visible","color"],"additionalProperties":false,"nullable":true},"sync":{"type":"object","properties":{"status":{"type":"string","enum":["idle","syncing","error"]},"error":{"type":"string","nullable":true},"lastSyncAt":{"type":"string","nullable":true}},"required":["status","error","lastSyncAt"],"additionalProperties":false}},"required":["id","provider","name","color","effectiveColor","timezone","teamSharing","effectiveRole","isPrimary","ownerUserId","ownerName","ownerImageUrl","ownerDepartments","connectionId","accountEmail","entry","sync"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/calendars/{id}/sharing":{"patch":{"summary":"Alterar compartilhamento da agenda","tags":["Calendar"],"description":"Só o dono da agenda pode alterar.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"teamSharing":{"type":"string","enum":["none","free_busy","read","write"],"description":"Compartilhamento com o escritório."}},"required":["teamSharing"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID da agenda."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"provider":{"type":"string","enum":["internal","google"]},"name":{"type":"string"},"color":{"type":"string"},"effectiveColor":{"type":"string"},"timezone":{"type":"string","nullable":true},"teamSharing":{"type":"string","enum":["none","free_busy","read","write"]},"effectiveRole":{"type":"string","enum":["owner","writer","reader","free_busy","none"]},"isPrimary":{"type":"boolean"},"ownerUserId":{"type":"string","nullable":true},"ownerName":{"type":"string","nullable":true},"ownerImageUrl":{"type":"string","nullable":true},"ownerDepartments":{"type":"array","items":{"type":"string"},"description":"Setores (departamentos) do dono, em ordem alfabética."},"connectionId":{"type":"string","nullable":true},"accountEmail":{"type":"string","nullable":true},"entry":{"type":"object","properties":{"enabled":{"type":"boolean"},"visible":{"type":"boolean"},"color":{"type":"string","nullable":true}},"required":["enabled","visible","color"],"additionalProperties":false,"nullable":true},"sync":{"type":"object","properties":{"status":{"type":"string","enum":["idle","syncing","error"]},"error":{"type":"string","nullable":true},"lastSyncAt":{"type":"string","nullable":true}},"required":["status","error","lastSyncAt"],"additionalProperties":false}},"required":["id","provider","name","color","effectiveColor","timezone","teamSharing","effectiveRole","isPrimary","ownerUserId","ownerName","ownerImageUrl","ownerDepartments","connectionId","accountEmail","entry","sync"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/calendars/{id}":{"patch":{"summary":"Alterar a cor da agenda interna","tags":["Calendar"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"required":["color"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID da agenda."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"provider":{"type":"string","enum":["internal","google"]},"name":{"type":"string"},"color":{"type":"string"},"effectiveColor":{"type":"string"},"timezone":{"type":"string","nullable":true},"teamSharing":{"type":"string","enum":["none","free_busy","read","write"]},"effectiveRole":{"type":"string","enum":["owner","writer","reader","free_busy","none"]},"isPrimary":{"type":"boolean"},"ownerUserId":{"type":"string","nullable":true},"ownerName":{"type":"string","nullable":true},"ownerImageUrl":{"type":"string","nullable":true},"ownerDepartments":{"type":"array","items":{"type":"string"},"description":"Setores (departamentos) do dono, em ordem alfabética."},"connectionId":{"type":"string","nullable":true},"accountEmail":{"type":"string","nullable":true},"entry":{"type":"object","properties":{"enabled":{"type":"boolean"},"visible":{"type":"boolean"},"color":{"type":"string","nullable":true}},"required":["enabled","visible","color"],"additionalProperties":false,"nullable":true},"sync":{"type":"object","properties":{"status":{"type":"string","enum":["idle","syncing","error"]},"error":{"type":"string","nullable":true},"lastSyncAt":{"type":"string","nullable":true}},"required":["status","error","lastSyncAt"],"additionalProperties":false}},"required":["id","provider","name","color","effectiveColor","timezone","teamSharing","effectiveRole","isPrimary","ownerUserId","ownerName","ownerImageUrl","ownerDepartments","connectionId","accountEmail","entry","sync"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/calendars/{id}/sync":{"post":{"summary":"Enfileirar sincronização da agenda","tags":["Calendar"],"description":"Gatilho manual (útil em desenvolvimento, onde os crons ficam desligados). Responde 202 assim que o job entra na fila.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["incremental","full"],"default":"incremental","description":"Modo da sincronização. Padrão `incremental`."}},"additionalProperties":false,"default":{}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID da agenda."}],"security":[{"apiKeyAuth":[]}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"queued":{"type":"boolean","enum":[true]}},"required":["queued"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/events":{"get":{"summary":"Listar eventos","tags":["Calendar"],"description":"Eventos das agendas acessíveis ao usuário no intervalo. Cada item já vem filtrado pelo papel efetivo: abaixo de leitura só sai o bloco de horário como \"Ocupado\". Tarefas nunca saem como \"Ocupado\"; as do usuário (um dos responsáveis ou criador) entram mesmo de agendas que ele não lê. Evento aparece também na agenda interna de cada participante (pedida em `calendarIds`) e sempre para o próprio participante. Com `inboxId` (workspace atual), saem os itens restritos a outros workspaces; o detalhe (`GET /calendar/events/:id`) não filtra por workspace. Intervalo de até 100 dias; a descrição não vem na listagem, só no detalhe.","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"start","required":true,"description":"Início do intervalo (exclusivo com o fim do evento)."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"end","required":true,"description":"Fim do intervalo (exclusivo com o início do evento)."},{"schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"in":"query","name":"calendarIds","required":false,"description":"Restringe às agendas informadas."},{"schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"in":"query","name":"calendarIds[]","required":false},{"schema":{"type":"boolean"},"in":"query","name":"linkedOnly","required":false,"description":"Só eventos com vínculo confirmado."},{"schema":{"type":"string","maxLength":200},"in":"query","name":"q","required":false,"description":"Busca em título, local ou e-mail de participante."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Cursor devolvido em `nextCursor`."},{"schema":{"type":"integer","minimum":1,"maximum":500,"default":200},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["event","task"]},"in":"query","name":"kind","required":false,"description":"Só eventos ou só tarefas."},{"schema":{"type":"boolean"},"in":"query","name":"assignedToMe","required":false,"description":"Só tarefas em que o usuário é um dos responsáveis."},{"schema":{"type":"string","minLength":1},"in":"query","name":"inboxId","required":false,"description":"Workspace atual: só entram itens sem workspaces (todos) ou com este. Só esconde itens; o acesso continua pelo papel na agenda. Omitido = sem filtro."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string"},"isAllDay":{"type":"boolean"},"startAt":{"type":"string","nullable":true},"endAt":{"type":"string","nullable":true},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"status":{"type":"string","enum":["confirmed","tentative","cancelled"]},"kind":{"type":"string","enum":["event","task"]},"title":{"type":"string"},"description":{"type":"string","nullable":true,"description":"Fora da listagem de eventos: o detalhe (`GET /calendar/events/:id`) traz o texto."},"location":{"type":"string","nullable":true},"meetLink":{"type":"string","nullable":true},"htmlLink":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"organizer":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true}},"required":["email","name"],"additionalProperties":false,"nullable":true},"attendees":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"],"additionalProperties":true}},"recurringEventId":{"type":"string","nullable":true},"recurrenceRule":{"type":"string","nullable":true},"isRecurring":{"type":"boolean"},"createdByUserId":{"type":"string","nullable":true},"remindersEnabled":{"type":"boolean"},"reminderOffsets":{"type":"array","items":{"type":"integer"},"description":"Frequência dos lembretes; `[]` = padrão do escritório."},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"imageUrl":{"type":"string","nullable":true}},"required":["id","name","imageUrl"],"additionalProperties":false},"description":"Responsáveis (tarefa) ou participantes (evento), em ordem de inclusão."},"inboxIds":{"type":"array","items":{"type":"string"},"description":"Workspaces (inboxes) onde o item aparece; `[]` = em todos."},"completedAt":{"type":"string","nullable":true},"completedByUserId":{"type":"string","nullable":true},"priority":{"type":"string","enum":["low","medium","high"],"nullable":true,"description":"Prioridade da tarefa; `null` em evento."},"attendance":{"type":"string","enum":["attended","no_show"],"nullable":true,"description":"Comparecimento marcado no evento; `null` = não marcado (sempre em tarefa)."},"busy":{"type":"boolean","enum":[false]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"personId":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"]},"status":{"type":"string","enum":["confirmed","suggested","dismissed"]},"clientResponse":{"type":"string","enum":["confirmed","reschedule_requested"],"nullable":true},"createdByUserId":{"type":"string","nullable":true},"createdAt":{"type":"string"},"conversation":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true},"integrationName":{"type":"string","nullable":true}},"required":["id"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","eventId","conversationId","personId","source","status","clientResponse","createdByUserId","createdAt"],"additionalProperties":false}},"reminders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"personId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"offsetMinutes":{"type":"number"},"scheduledFor":{"type":"string"},"status":{"type":"string","enum":["scheduled","sent","failed","cancelled","skipped"]},"skipReason":{"type":"string","nullable":true},"sentAt":{"type":"string","nullable":true},"error":{"type":"string","nullable":true},"createdAt":{"type":"string"}},"required":["id","eventId","personId","conversationId","offsetMinutes","scheduledFor","status","skipReason","sentAt","error","createdAt"],"additionalProperties":false}}},"required":["id","calendarId","isAllDay","startAt","endAt","startDate","endDate","status","kind","title","location","meetLink","htmlLink","timezone","organizer","attendees","recurringEventId","recurrenceRule","isRecurring","createdByUserId","remindersEnabled","reminderOffsets","assignees","inboxIds","completedAt","completedByUserId","priority","attendance","busy","createdAt","updatedAt"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string"},"isAllDay":{"type":"boolean"},"startAt":{"type":"string","nullable":true},"endAt":{"type":"string","nullable":true},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"status":{"type":"string","enum":["confirmed","tentative","cancelled"]},"title":{"type":"string","enum":["Ocupado"]},"busy":{"type":"boolean","enum":[true]}},"required":["id","calendarId","isAllDay","startAt","endAt","startDate","endDate","status","title","busy"],"additionalProperties":false}]}},"nextCursor":{"type":"string","nullable":true}},"required":["items","nextCursor"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Criar evento","tags":["Calendar"],"description":"Agenda Google: grava no Google e depois no Jurichat (write-through). Agenda interna: grava direto; com recorrência, grava uma linha por ocorrência até hoje + 18 meses (devolve a primeira). Google Meet só em agendas Google; `meetLink` vale para as duas. `kind: task` cria tarefa (só agenda interna): prazo em `startDate` ou `startAt` (fim calculado), `assigneeUserIds` (padrão: `[quem cria]`; o antigo `assigneeUserId` vale como `[id]`), sem repetição, participantes, videochamada nem lembretes. Evento aceita `assigneeUserIds` como participantes do escritório (série interna: todas as ocorrências; série do Google com participantes responde 400). `inboxIds` escolhe os workspaces onde o item aparece (omitido = todos; série interna: todas as ocorrências).","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":500},"description":{"type":"string","maxLength":50000,"nullable":true},"location":{"type":"string","maxLength":1000,"nullable":true},"isAllDay":{"type":"boolean","default":false},"startAt":{"type":"string","format":"date-time","description":"Data e hora em ISO 8601 (com offset ou `Z`)."},"endAt":{"type":"string","format":"date-time","description":"Data e hora em ISO 8601 (com offset ou `Z`)."},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Início do evento de dia inteiro (YYYY-MM-DD)."},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Fim exclusivo do evento de dia inteiro (YYYY-MM-DD). Omitido = dia seguinte ao início."},"timezone":{"type":"string","minLength":1,"maxLength":64,"nullable":true},"meetLink":{"type":"string","maxLength":2000,"format":"uri","pattern":"^https?:\\/\\/","description":"Link de videochamada (http/https). Em agenda Google, o Meet do evento tem prioridade.","nullable":true},"attendees":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string","format":"email","description":"E-mail do participante."},"name":{"type":"string","maxLength":200,"nullable":true}},"required":["email"],"additionalProperties":false},"maxItems":100},"createMeet":{"type":"boolean"},"recurrence":{"type":"string","enum":["none","daily","weekly","monthly","weekdays"]},"sendUpdates":{"type":"string","enum":["all","externalOnly","none"],"default":"none"},"remindersEnabled":{"type":"boolean"},"reminderOffsets":{"type":"array","items":{"type":"integer"},"maxItems":3,"description":"Frequência dos lembretes deste evento (1440, 60, 30); `[]` = padrão do escritório."},"kind":{"type":"string","enum":["event","task"],"description":"`task`: tarefa com prazo, responsáveis e conclusão (só agendas do JuriChat).","default":"event"},"assigneeUserIds":{"type":"array","items":{"type":"string","minLength":1},"maxItems":20,"description":"Responsáveis (tarefa) ou participantes (evento): usuários do escritório, até 20; repetidos são ignorados. Tarefa exige ao menos um (padrão: quem cria); evento aceita lista vazia (padrão: nenhum) e aparece na agenda de cada participante. Na edição substitui a lista inteira."},"assigneeUserId":{"type":"string","minLength":1,"description":"Obsoleto: use `assigneeUserIds`. Sem `assigneeUserIds`, vale como `[assigneeUserId]`."},"priority":{"type":"string","enum":["low","medium","high"],"description":"Só tarefa: `low`, `medium` ou `high` (padrão na criação: `low`)."},"inboxIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":100,"description":"Workspaces (inboxes) onde o item aparece. Valem só os do escritório a que quem grava tem acesso; os demais são ignorados e, se nenhum sobrar, 400 `INBOX_REQUIRED`. Todos os do escritório gravam `[]` (aparece em todos, inclusive nos criados depois). Criação: omitido = todos. Edição: omitido não mexe; presente substitui a lista, mantendo os workspaces do item a que quem edita não tem acesso."},"calendarId":{"type":"string","description":"Agenda de destino."},"links":{"type":"array","items":{"type":"object","properties":{"conversationId":{"type":"string"},"personId":{"type":"string"}},"additionalProperties":false},"maxItems":20}},"required":["title","calendarId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string"},"isAllDay":{"type":"boolean"},"startAt":{"type":"string","nullable":true},"endAt":{"type":"string","nullable":true},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"status":{"type":"string","enum":["confirmed","tentative","cancelled"]},"kind":{"type":"string","enum":["event","task"]},"title":{"type":"string"},"description":{"type":"string","nullable":true,"description":"Fora da listagem de eventos: o detalhe (`GET /calendar/events/:id`) traz o texto."},"location":{"type":"string","nullable":true},"meetLink":{"type":"string","nullable":true},"htmlLink":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"organizer":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true}},"required":["email","name"],"additionalProperties":false,"nullable":true},"attendees":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"],"additionalProperties":true}},"recurringEventId":{"type":"string","nullable":true},"recurrenceRule":{"type":"string","nullable":true},"isRecurring":{"type":"boolean"},"createdByUserId":{"type":"string","nullable":true},"remindersEnabled":{"type":"boolean"},"reminderOffsets":{"type":"array","items":{"type":"integer"},"description":"Frequência dos lembretes; `[]` = padrão do escritório."},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"imageUrl":{"type":"string","nullable":true}},"required":["id","name","imageUrl"],"additionalProperties":false},"description":"Responsáveis (tarefa) ou participantes (evento), em ordem de inclusão."},"inboxIds":{"type":"array","items":{"type":"string"},"description":"Workspaces (inboxes) onde o item aparece; `[]` = em todos."},"completedAt":{"type":"string","nullable":true},"completedByUserId":{"type":"string","nullable":true},"priority":{"type":"string","enum":["low","medium","high"],"nullable":true,"description":"Prioridade da tarefa; `null` em evento."},"attendance":{"type":"string","enum":["attended","no_show"],"nullable":true,"description":"Comparecimento marcado no evento; `null` = não marcado (sempre em tarefa)."},"busy":{"type":"boolean","enum":[false]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"personId":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"]},"status":{"type":"string","enum":["confirmed","suggested","dismissed"]},"clientResponse":{"type":"string","enum":["confirmed","reschedule_requested"],"nullable":true},"createdByUserId":{"type":"string","nullable":true},"createdAt":{"type":"string"},"conversation":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true},"integrationName":{"type":"string","nullable":true}},"required":["id"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","eventId","conversationId","personId","source","status","clientResponse","createdByUserId","createdAt"],"additionalProperties":false}},"reminders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"personId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"offsetMinutes":{"type":"number"},"scheduledFor":{"type":"string"},"status":{"type":"string","enum":["scheduled","sent","failed","cancelled","skipped"]},"skipReason":{"type":"string","nullable":true},"sentAt":{"type":"string","nullable":true},"error":{"type":"string","nullable":true},"createdAt":{"type":"string"}},"required":["id","eventId","personId","conversationId","offsetMinutes","scheduledFor","status","skipReason","sentAt","error","createdAt"],"additionalProperties":false}}},"required":["id","calendarId","isAllDay","startAt","endAt","startDate","endDate","status","kind","title","location","meetLink","htmlLink","timezone","organizer","attendees","recurringEventId","recurrenceRule","isRecurring","createdByUserId","remindersEnabled","reminderOffsets","assignees","inboxIds","completedAt","completedByUserId","priority","attendance","busy","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/events/{id}":{"get":{"summary":"Detalhe do evento","tags":["Calendar"],"description":"Com papel de leitura devolve vínculos e lembretes; abaixo disso só o horário.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do evento."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string"},"isAllDay":{"type":"boolean"},"startAt":{"type":"string","nullable":true},"endAt":{"type":"string","nullable":true},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"status":{"type":"string","enum":["confirmed","tentative","cancelled"]},"kind":{"type":"string","enum":["event","task"]},"title":{"type":"string"},"description":{"type":"string","nullable":true,"description":"Fora da listagem de eventos: o detalhe (`GET /calendar/events/:id`) traz o texto."},"location":{"type":"string","nullable":true},"meetLink":{"type":"string","nullable":true},"htmlLink":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"organizer":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true}},"required":["email","name"],"additionalProperties":false,"nullable":true},"attendees":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"],"additionalProperties":true}},"recurringEventId":{"type":"string","nullable":true},"recurrenceRule":{"type":"string","nullable":true},"isRecurring":{"type":"boolean"},"createdByUserId":{"type":"string","nullable":true},"remindersEnabled":{"type":"boolean"},"reminderOffsets":{"type":"array","items":{"type":"integer"},"description":"Frequência dos lembretes; `[]` = padrão do escritório."},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"imageUrl":{"type":"string","nullable":true}},"required":["id","name","imageUrl"],"additionalProperties":false},"description":"Responsáveis (tarefa) ou participantes (evento), em ordem de inclusão."},"inboxIds":{"type":"array","items":{"type":"string"},"description":"Workspaces (inboxes) onde o item aparece; `[]` = em todos."},"completedAt":{"type":"string","nullable":true},"completedByUserId":{"type":"string","nullable":true},"priority":{"type":"string","enum":["low","medium","high"],"nullable":true,"description":"Prioridade da tarefa; `null` em evento."},"attendance":{"type":"string","enum":["attended","no_show"],"nullable":true,"description":"Comparecimento marcado no evento; `null` = não marcado (sempre em tarefa)."},"busy":{"type":"boolean","enum":[false]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"personId":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"]},"status":{"type":"string","enum":["confirmed","suggested","dismissed"]},"clientResponse":{"type":"string","enum":["confirmed","reschedule_requested"],"nullable":true},"createdByUserId":{"type":"string","nullable":true},"createdAt":{"type":"string"},"conversation":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true},"integrationName":{"type":"string","nullable":true}},"required":["id"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","eventId","conversationId","personId","source","status","clientResponse","createdByUserId","createdAt"],"additionalProperties":false}},"reminders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"personId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"offsetMinutes":{"type":"number"},"scheduledFor":{"type":"string"},"status":{"type":"string","enum":["scheduled","sent","failed","cancelled","skipped"]},"skipReason":{"type":"string","nullable":true},"sentAt":{"type":"string","nullable":true},"error":{"type":"string","nullable":true},"createdAt":{"type":"string"}},"required":["id","eventId","personId","conversationId","offsetMinutes","scheduledFor","status","skipReason","sentAt","error","createdAt"],"additionalProperties":false}}},"required":["id","calendarId","isAllDay","startAt","endAt","startDate","endDate","status","kind","title","location","meetLink","htmlLink","timezone","organizer","attendees","recurringEventId","recurrenceRule","isRecurring","createdByUserId","remindersEnabled","reminderOffsets","assignees","inboxIds","completedAt","completedByUserId","priority","attendance","busy","createdAt","updatedAt"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string"},"isAllDay":{"type":"boolean"},"startAt":{"type":"string","nullable":true},"endAt":{"type":"string","nullable":true},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"status":{"type":"string","enum":["confirmed","tentative","cancelled"]},"title":{"type":"string","enum":["Ocupado"]},"busy":{"type":"boolean","enum":[true]}},"required":["id","calendarId","isAllDay","startAt","endAt","startDate","endDate","status","title","busy"],"additionalProperties":false}]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Editar evento","tags":["Calendar"],"description":"Envia ao Google só o que mudou. `scope=all` edita a série (no Google pelo evento mestre; na agenda interna em todas as ocorrências) e aplica mudança de horário como deslocamento. Tarefa ignora `scope`; `assigneeUserIds` substitui a lista de responsáveis (tarefa) ou participantes (evento, segue o `scope` na série interna) e notifica só quem entrou. `inboxIds` substitui os workspaces (segue o `scope` na série interna) e mantém os que quem edita não acessa. Trocar `kind` responde 400.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":500},"description":{"type":"string","maxLength":50000,"nullable":true},"location":{"type":"string","maxLength":1000,"nullable":true},"isAllDay":{"type":"boolean"},"startAt":{"type":"string","format":"date-time","description":"Data e hora em ISO 8601 (com offset ou `Z`)."},"endAt":{"type":"string","format":"date-time","description":"Data e hora em ISO 8601 (com offset ou `Z`)."},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Início do evento de dia inteiro (YYYY-MM-DD)."},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Fim exclusivo do evento de dia inteiro (YYYY-MM-DD). Omitido = dia seguinte ao início."},"timezone":{"type":"string","minLength":1,"maxLength":64,"nullable":true},"meetLink":{"type":"string","maxLength":2000,"format":"uri","pattern":"^https?:\\/\\/","description":"Link de videochamada (http/https). Em agenda Google, o Meet do evento tem prioridade.","nullable":true},"attendees":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string","format":"email","description":"E-mail do participante."},"name":{"type":"string","maxLength":200,"nullable":true}},"required":["email"],"additionalProperties":false},"maxItems":100},"createMeet":{"type":"boolean"},"recurrence":{"type":"string","enum":["none","daily","weekly","monthly","weekdays"]},"sendUpdates":{"type":"string","enum":["all","externalOnly","none"]},"remindersEnabled":{"type":"boolean"},"reminderOffsets":{"type":"array","items":{"type":"integer"},"maxItems":3,"description":"Frequência dos lembretes deste evento (1440, 60, 30); `[]` = padrão do escritório."},"kind":{"type":"string","enum":["event","task"],"description":"`task`: tarefa com prazo, responsáveis e conclusão (só agendas do JuriChat)."},"assigneeUserIds":{"type":"array","items":{"type":"string","minLength":1},"maxItems":20,"description":"Responsáveis (tarefa) ou participantes (evento): usuários do escritório, até 20; repetidos são ignorados. Tarefa exige ao menos um (padrão: quem cria); evento aceita lista vazia (padrão: nenhum) e aparece na agenda de cada participante. Na edição substitui a lista inteira."},"assigneeUserId":{"type":"string","minLength":1,"description":"Obsoleto: use `assigneeUserIds`. Sem `assigneeUserIds`, vale como `[assigneeUserId]`."},"priority":{"type":"string","enum":["low","medium","high"],"description":"Só tarefa: `low`, `medium` ou `high` (padrão na criação: `low`)."},"inboxIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":100,"description":"Workspaces (inboxes) onde o item aparece. Valem só os do escritório a que quem grava tem acesso; os demais são ignorados e, se nenhum sobrar, 400 `INBOX_REQUIRED`. Todos os do escritório gravam `[]` (aparece em todos, inclusive nos criados depois). Criação: omitido = todos. Edição: omitido não mexe; presente substitui a lista, mantendo os workspaces do item a que quem edita não tem acesso."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","enum":["this","all"],"default":"this"},"in":"query","name":"scope","required":false,"description":"`this`: só esta instância; `all`: toda a série (agenda Google ou interna)."},{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do evento."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string"},"isAllDay":{"type":"boolean"},"startAt":{"type":"string","nullable":true},"endAt":{"type":"string","nullable":true},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"status":{"type":"string","enum":["confirmed","tentative","cancelled"]},"kind":{"type":"string","enum":["event","task"]},"title":{"type":"string"},"description":{"type":"string","nullable":true,"description":"Fora da listagem de eventos: o detalhe (`GET /calendar/events/:id`) traz o texto."},"location":{"type":"string","nullable":true},"meetLink":{"type":"string","nullable":true},"htmlLink":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"organizer":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true}},"required":["email","name"],"additionalProperties":false,"nullable":true},"attendees":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"],"additionalProperties":true}},"recurringEventId":{"type":"string","nullable":true},"recurrenceRule":{"type":"string","nullable":true},"isRecurring":{"type":"boolean"},"createdByUserId":{"type":"string","nullable":true},"remindersEnabled":{"type":"boolean"},"reminderOffsets":{"type":"array","items":{"type":"integer"},"description":"Frequência dos lembretes; `[]` = padrão do escritório."},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"imageUrl":{"type":"string","nullable":true}},"required":["id","name","imageUrl"],"additionalProperties":false},"description":"Responsáveis (tarefa) ou participantes (evento), em ordem de inclusão."},"inboxIds":{"type":"array","items":{"type":"string"},"description":"Workspaces (inboxes) onde o item aparece; `[]` = em todos."},"completedAt":{"type":"string","nullable":true},"completedByUserId":{"type":"string","nullable":true},"priority":{"type":"string","enum":["low","medium","high"],"nullable":true,"description":"Prioridade da tarefa; `null` em evento."},"attendance":{"type":"string","enum":["attended","no_show"],"nullable":true,"description":"Comparecimento marcado no evento; `null` = não marcado (sempre em tarefa)."},"busy":{"type":"boolean","enum":[false]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"personId":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"]},"status":{"type":"string","enum":["confirmed","suggested","dismissed"]},"clientResponse":{"type":"string","enum":["confirmed","reschedule_requested"],"nullable":true},"createdByUserId":{"type":"string","nullable":true},"createdAt":{"type":"string"},"conversation":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true},"integrationName":{"type":"string","nullable":true}},"required":["id"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","eventId","conversationId","personId","source","status","clientResponse","createdByUserId","createdAt"],"additionalProperties":false}},"reminders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"personId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"offsetMinutes":{"type":"number"},"scheduledFor":{"type":"string"},"status":{"type":"string","enum":["scheduled","sent","failed","cancelled","skipped"]},"skipReason":{"type":"string","nullable":true},"sentAt":{"type":"string","nullable":true},"error":{"type":"string","nullable":true},"createdAt":{"type":"string"}},"required":["id","eventId","personId","conversationId","offsetMinutes","scheduledFor","status","skipReason","sentAt","error","createdAt"],"additionalProperties":false}}},"required":["id","calendarId","isAllDay","startAt","endAt","startDate","endDate","status","kind","title","location","meetLink","htmlLink","timezone","organizer","attendees","recurringEventId","recurrenceRule","isRecurring","createdByUserId","remindersEnabled","reminderOffsets","assignees","inboxIds","completedAt","completedByUserId","priority","attendance","busy","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir evento","tags":["Calendar"],"parameters":[{"schema":{"type":"string","enum":["this","all"],"default":"this"},"in":"query","name":"scope","required":false,"description":"`this`: só esta instância; `all`: toda a série (agenda Google ou interna)."},{"schema":{"type":"string","enum":["all","externalOnly","none"],"default":"none"},"in":"query","name":"sendUpdates","required":false},{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do evento."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"],"nullable":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/events/{id}/reminders":{"get":{"summary":"Lembretes do evento","tags":["Calendar"],"description":"Lembretes por WhatsApp do evento com status, horário previsto, motivo de pulo e erro. Exige papel de leitura na agenda.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do evento."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"personId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"offsetMinutes":{"type":"number"},"scheduledFor":{"type":"string"},"status":{"type":"string","enum":["scheduled","sent","failed","cancelled","skipped"]},"skipReason":{"type":"string","nullable":true},"sentAt":{"type":"string","nullable":true},"error":{"type":"string","nullable":true},"createdAt":{"type":"string"}},"required":["id","eventId","personId","conversationId","offsetMinutes","scheduledFor","status","skipReason","sentAt","error","createdAt"],"additionalProperties":false}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/events/{id}/complete":{"post":{"summary":"Concluir tarefa","tags":["Calendar"],"description":"Grava `completedAt` e `completedByUserId`. Pode qualquer responsável, o criador ou quem tem escrita na agenda. Evento (não tarefa) responde 400.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do evento."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string"},"isAllDay":{"type":"boolean"},"startAt":{"type":"string","nullable":true},"endAt":{"type":"string","nullable":true},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"status":{"type":"string","enum":["confirmed","tentative","cancelled"]},"kind":{"type":"string","enum":["event","task"]},"title":{"type":"string"},"description":{"type":"string","nullable":true,"description":"Fora da listagem de eventos: o detalhe (`GET /calendar/events/:id`) traz o texto."},"location":{"type":"string","nullable":true},"meetLink":{"type":"string","nullable":true},"htmlLink":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"organizer":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true}},"required":["email","name"],"additionalProperties":false,"nullable":true},"attendees":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"],"additionalProperties":true}},"recurringEventId":{"type":"string","nullable":true},"recurrenceRule":{"type":"string","nullable":true},"isRecurring":{"type":"boolean"},"createdByUserId":{"type":"string","nullable":true},"remindersEnabled":{"type":"boolean"},"reminderOffsets":{"type":"array","items":{"type":"integer"},"description":"Frequência dos lembretes; `[]` = padrão do escritório."},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"imageUrl":{"type":"string","nullable":true}},"required":["id","name","imageUrl"],"additionalProperties":false},"description":"Responsáveis (tarefa) ou participantes (evento), em ordem de inclusão."},"inboxIds":{"type":"array","items":{"type":"string"},"description":"Workspaces (inboxes) onde o item aparece; `[]` = em todos."},"completedAt":{"type":"string","nullable":true},"completedByUserId":{"type":"string","nullable":true},"priority":{"type":"string","enum":["low","medium","high"],"nullable":true,"description":"Prioridade da tarefa; `null` em evento."},"attendance":{"type":"string","enum":["attended","no_show"],"nullable":true,"description":"Comparecimento marcado no evento; `null` = não marcado (sempre em tarefa)."},"busy":{"type":"boolean","enum":[false]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"personId":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"]},"status":{"type":"string","enum":["confirmed","suggested","dismissed"]},"clientResponse":{"type":"string","enum":["confirmed","reschedule_requested"],"nullable":true},"createdByUserId":{"type":"string","nullable":true},"createdAt":{"type":"string"},"conversation":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true},"integrationName":{"type":"string","nullable":true}},"required":["id"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","eventId","conversationId","personId","source","status","clientResponse","createdByUserId","createdAt"],"additionalProperties":false}},"reminders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"personId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"offsetMinutes":{"type":"number"},"scheduledFor":{"type":"string"},"status":{"type":"string","enum":["scheduled","sent","failed","cancelled","skipped"]},"skipReason":{"type":"string","nullable":true},"sentAt":{"type":"string","nullable":true},"error":{"type":"string","nullable":true},"createdAt":{"type":"string"}},"required":["id","eventId","personId","conversationId","offsetMinutes","scheduledFor","status","skipReason","sentAt","error","createdAt"],"additionalProperties":false}}},"required":["id","calendarId","isAllDay","startAt","endAt","startDate","endDate","status","kind","title","location","meetLink","htmlLink","timezone","organizer","attendees","recurringEventId","recurrenceRule","isRecurring","createdByUserId","remindersEnabled","reminderOffsets","assignees","inboxIds","completedAt","completedByUserId","priority","attendance","busy","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/events/{id}/reopen":{"post":{"summary":"Reabrir tarefa","tags":["Calendar"],"description":"Limpa `completedAt` e `completedByUserId`. Mesmas permissões de concluir.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do evento."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string"},"isAllDay":{"type":"boolean"},"startAt":{"type":"string","nullable":true},"endAt":{"type":"string","nullable":true},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"status":{"type":"string","enum":["confirmed","tentative","cancelled"]},"kind":{"type":"string","enum":["event","task"]},"title":{"type":"string"},"description":{"type":"string","nullable":true,"description":"Fora da listagem de eventos: o detalhe (`GET /calendar/events/:id`) traz o texto."},"location":{"type":"string","nullable":true},"meetLink":{"type":"string","nullable":true},"htmlLink":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"organizer":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true}},"required":["email","name"],"additionalProperties":false,"nullable":true},"attendees":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"],"additionalProperties":true}},"recurringEventId":{"type":"string","nullable":true},"recurrenceRule":{"type":"string","nullable":true},"isRecurring":{"type":"boolean"},"createdByUserId":{"type":"string","nullable":true},"remindersEnabled":{"type":"boolean"},"reminderOffsets":{"type":"array","items":{"type":"integer"},"description":"Frequência dos lembretes; `[]` = padrão do escritório."},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"imageUrl":{"type":"string","nullable":true}},"required":["id","name","imageUrl"],"additionalProperties":false},"description":"Responsáveis (tarefa) ou participantes (evento), em ordem de inclusão."},"inboxIds":{"type":"array","items":{"type":"string"},"description":"Workspaces (inboxes) onde o item aparece; `[]` = em todos."},"completedAt":{"type":"string","nullable":true},"completedByUserId":{"type":"string","nullable":true},"priority":{"type":"string","enum":["low","medium","high"],"nullable":true,"description":"Prioridade da tarefa; `null` em evento."},"attendance":{"type":"string","enum":["attended","no_show"],"nullable":true,"description":"Comparecimento marcado no evento; `null` = não marcado (sempre em tarefa)."},"busy":{"type":"boolean","enum":[false]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"personId":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"]},"status":{"type":"string","enum":["confirmed","suggested","dismissed"]},"clientResponse":{"type":"string","enum":["confirmed","reschedule_requested"],"nullable":true},"createdByUserId":{"type":"string","nullable":true},"createdAt":{"type":"string"},"conversation":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true},"integrationName":{"type":"string","nullable":true}},"required":["id"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","eventId","conversationId","personId","source","status","clientResponse","createdByUserId","createdAt"],"additionalProperties":false}},"reminders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"personId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"offsetMinutes":{"type":"number"},"scheduledFor":{"type":"string"},"status":{"type":"string","enum":["scheduled","sent","failed","cancelled","skipped"]},"skipReason":{"type":"string","nullable":true},"sentAt":{"type":"string","nullable":true},"error":{"type":"string","nullable":true},"createdAt":{"type":"string"}},"required":["id","eventId","personId","conversationId","offsetMinutes","scheduledFor","status","skipReason","sentAt","error","createdAt"],"additionalProperties":false}}},"required":["id","calendarId","isAllDay","startAt","endAt","startDate","endDate","status","kind","title","location","meetLink","htmlLink","timezone","organizer","attendees","recurringEventId","recurrenceRule","isRecurring","createdByUserId","remindersEnabled","reminderOffsets","assignees","inboxIds","completedAt","completedByUserId","priority","attendance","busy","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/events/{id}/attendance":{"put":{"summary":"Marcar comparecimento","tags":["Calendar"],"description":"Só evento (tarefa responde 400) e com a confirmação de comparecimento ligada no escritório e no workspace do `inboxId`, se vier (senão 400). Pode qualquer participante, o criador ou quem tem escrita na agenda. Vale só para a ocorrência, nunca para a série.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"attendance":{"type":"string","enum":["attended","no_show"],"nullable":true,"description":"`attended` (compareceu), `no_show` (não compareceu) ou `null` (desmarca)."},"inboxId":{"type":"string","minLength":1,"description":"Workspace atual. Com a confirmação restrita a workspaces, fora deles responde 400. Omitido = vale só a chave do escritório."}},"required":["attendance"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do evento."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string"},"isAllDay":{"type":"boolean"},"startAt":{"type":"string","nullable":true},"endAt":{"type":"string","nullable":true},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"status":{"type":"string","enum":["confirmed","tentative","cancelled"]},"kind":{"type":"string","enum":["event","task"]},"title":{"type":"string"},"description":{"type":"string","nullable":true,"description":"Fora da listagem de eventos: o detalhe (`GET /calendar/events/:id`) traz o texto."},"location":{"type":"string","nullable":true},"meetLink":{"type":"string","nullable":true},"htmlLink":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"organizer":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true}},"required":["email","name"],"additionalProperties":false,"nullable":true},"attendees":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"],"additionalProperties":true}},"recurringEventId":{"type":"string","nullable":true},"recurrenceRule":{"type":"string","nullable":true},"isRecurring":{"type":"boolean"},"createdByUserId":{"type":"string","nullable":true},"remindersEnabled":{"type":"boolean"},"reminderOffsets":{"type":"array","items":{"type":"integer"},"description":"Frequência dos lembretes; `[]` = padrão do escritório."},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"imageUrl":{"type":"string","nullable":true}},"required":["id","name","imageUrl"],"additionalProperties":false},"description":"Responsáveis (tarefa) ou participantes (evento), em ordem de inclusão."},"inboxIds":{"type":"array","items":{"type":"string"},"description":"Workspaces (inboxes) onde o item aparece; `[]` = em todos."},"completedAt":{"type":"string","nullable":true},"completedByUserId":{"type":"string","nullable":true},"priority":{"type":"string","enum":["low","medium","high"],"nullable":true,"description":"Prioridade da tarefa; `null` em evento."},"attendance":{"type":"string","enum":["attended","no_show"],"nullable":true,"description":"Comparecimento marcado no evento; `null` = não marcado (sempre em tarefa)."},"busy":{"type":"boolean","enum":[false]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"personId":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"]},"status":{"type":"string","enum":["confirmed","suggested","dismissed"]},"clientResponse":{"type":"string","enum":["confirmed","reschedule_requested"],"nullable":true},"createdByUserId":{"type":"string","nullable":true},"createdAt":{"type":"string"},"conversation":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true},"integrationName":{"type":"string","nullable":true}},"required":["id"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","eventId","conversationId","personId","source","status","clientResponse","createdByUserId","createdAt"],"additionalProperties":false}},"reminders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"personId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"offsetMinutes":{"type":"number"},"scheduledFor":{"type":"string"},"status":{"type":"string","enum":["scheduled","sent","failed","cancelled","skipped"]},"skipReason":{"type":"string","nullable":true},"sentAt":{"type":"string","nullable":true},"error":{"type":"string","nullable":true},"createdAt":{"type":"string"}},"required":["id","eventId","personId","conversationId","offsetMinutes","scheduledFor","status","skipReason","sentAt","error","createdAt"],"additionalProperties":false}}},"required":["id","calendarId","isAllDay","startAt","endAt","startDate","endDate","status","kind","title","location","meetLink","htmlLink","timezone","organizer","attendees","recurringEventId","recurrenceRule","isRecurring","createdByUserId","remindersEnabled","reminderOffsets","assignees","inboxIds","completedAt","completedByUserId","priority","attendance","busy","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/events/{id}/links":{"post":{"summary":"Vincular evento a uma conversa ou contato","tags":["Calendar"],"description":"Exatamente um alvo. Vincular a uma conversa também cria o vínculo com o contato dela. Idempotente: vínculos já existentes são devolvidos sem duplicar.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","minLength":1,"nullable":true,"description":"Conversa a vincular."},"personId":{"type":"string","minLength":1,"nullable":true,"description":"Contato a vincular."},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"],"description":"Origem do vínculo. Padrão `manual`."},"status":{"type":"string","enum":["confirmed","suggested"],"description":"Estado inicial. Padrão `confirmed`."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true,"description":"ID do evento."}],"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"personId":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"]},"status":{"type":"string","enum":["confirmed","suggested","dismissed"]},"clientResponse":{"type":"string","enum":["confirmed","reschedule_requested"],"nullable":true},"createdByUserId":{"type":"string","nullable":true},"createdAt":{"type":"string"},"conversation":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true}},"required":["id"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","eventId","conversationId","personId","source","status","clientResponse","createdByUserId","createdAt"],"additionalProperties":false}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/links/{id}":{"delete":{"summary":"Remover vínculo","tags":["Calendar"],"parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true,"description":"ID do vínculo."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"],"nullable":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/links/{id}/confirm":{"post":{"summary":"Confirmar vínculo sugerido","tags":["Calendar"],"parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true,"description":"ID do vínculo."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"personId":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"]},"status":{"type":"string","enum":["confirmed","suggested","dismissed"]},"clientResponse":{"type":"string","enum":["confirmed","reschedule_requested"],"nullable":true},"createdByUserId":{"type":"string","nullable":true},"createdAt":{"type":"string"},"conversation":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true}},"required":["id"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","eventId","conversationId","personId","source","status","clientResponse","createdByUserId","createdAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/links/{id}/dismiss":{"post":{"summary":"Descartar vínculo sugerido","tags":["Calendar"],"description":"O vínculo fica como `dismissed` e nunca é recriado automaticamente; só uma ação manual do usuário o reativa.","parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true,"description":"ID do vínculo."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"personId":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"]},"status":{"type":"string","enum":["confirmed","suggested","dismissed"]},"clientResponse":{"type":"string","enum":["confirmed","reschedule_requested"],"nullable":true},"createdByUserId":{"type":"string","nullable":true},"createdAt":{"type":"string"},"conversation":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true}},"required":["id"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","eventId","conversationId","personId","source","status","clientResponse","createdByUserId","createdAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/conversations/{conversationId}/events":{"get":{"summary":"Eventos vinculados a uma conversa","tags":["Calendar"],"description":"União dos eventos vinculados à conversa e ao contato dela, sem duplicar. Eventos de agendas em que o usuário não tem papel >= reader ficam de fora (inclusive livre/ocupado: listar o bloco revelaria o vínculo). Só entram os eventos do workspace da conversa (sem workspaces = todos).","parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"conversationId","required":true,"description":"ID da conversa."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"upcoming":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string"},"isAllDay":{"type":"boolean"},"startAt":{"type":"string","nullable":true},"endAt":{"type":"string","nullable":true},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"status":{"type":"string","enum":["confirmed","tentative","cancelled"]},"title":{"type":"string"},"description":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"meetLink":{"type":"string","nullable":true},"htmlLink":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"organizer":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true}},"required":["email","name"],"additionalProperties":false,"nullable":true},"attendees":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true},"responseStatus":{"type":"string","nullable":true},"self":{"type":"boolean"},"organizer":{"type":"boolean"}},"required":["email"],"additionalProperties":false}},"recurringEventId":{"type":"string","nullable":true},"recurrenceRule":{"type":"string","nullable":true},"isRecurring":{"type":"boolean"},"createdByUserId":{"type":"string","nullable":true},"remindersEnabled":{"type":"boolean"},"busy":{"type":"boolean","enum":[false]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"personId":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"]},"status":{"type":"string","enum":["confirmed","suggested","dismissed"]},"clientResponse":{"type":"string","enum":["confirmed","reschedule_requested"],"nullable":true},"createdByUserId":{"type":"string","nullable":true},"createdAt":{"type":"string"},"conversation":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true}},"required":["id"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","eventId","conversationId","personId","source","status","clientResponse","createdByUserId","createdAt"],"additionalProperties":false}}},"required":["id","calendarId","isAllDay","startAt","endAt","startDate","endDate","status","title","description","location","meetLink","htmlLink","timezone","organizer","attendees","recurringEventId","recurrenceRule","isRecurring","createdByUserId","remindersEnabled","busy","createdAt","updatedAt"],"additionalProperties":false},"description":"Início >= agora, em ordem crescente."},"past":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string"},"isAllDay":{"type":"boolean"},"startAt":{"type":"string","nullable":true},"endAt":{"type":"string","nullable":true},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"status":{"type":"string","enum":["confirmed","tentative","cancelled"]},"title":{"type":"string"},"description":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"meetLink":{"type":"string","nullable":true},"htmlLink":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"organizer":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true}},"required":["email","name"],"additionalProperties":false,"nullable":true},"attendees":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true},"responseStatus":{"type":"string","nullable":true},"self":{"type":"boolean"},"organizer":{"type":"boolean"}},"required":["email"],"additionalProperties":false}},"recurringEventId":{"type":"string","nullable":true},"recurrenceRule":{"type":"string","nullable":true},"isRecurring":{"type":"boolean"},"createdByUserId":{"type":"string","nullable":true},"remindersEnabled":{"type":"boolean"},"busy":{"type":"boolean","enum":[false]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"personId":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"]},"status":{"type":"string","enum":["confirmed","suggested","dismissed"]},"clientResponse":{"type":"string","enum":["confirmed","reschedule_requested"],"nullable":true},"createdByUserId":{"type":"string","nullable":true},"createdAt":{"type":"string"},"conversation":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true}},"required":["id"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","eventId","conversationId","personId","source","status","clientResponse","createdByUserId","createdAt"],"additionalProperties":false}}},"required":["id","calendarId","isAllDay","startAt","endAt","startDate","endDate","status","title","description","location","meetLink","htmlLink","timezone","organizer","attendees","recurringEventId","recurrenceRule","isRecurring","createdByUserId","remindersEnabled","busy","createdAt","updatedAt"],"additionalProperties":false},"description":"Já iniciados, do mais recente ao mais antigo."}},"required":["upcoming","past"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/people/{personId}/events":{"get":{"summary":"Eventos vinculados a um contato","tags":["Calendar"],"description":"União dos eventos vinculados ao contato e às conversas dele, sem duplicar. Eventos de agendas em que o usuário não tem papel >= reader ficam de fora (inclusive livre/ocupado: listar o bloco revelaria o vínculo). Só entram os eventos do workspace do contato (sem workspaces = todos).","parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"personId","required":true,"description":"ID do contato."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"upcoming":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string"},"isAllDay":{"type":"boolean"},"startAt":{"type":"string","nullable":true},"endAt":{"type":"string","nullable":true},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"status":{"type":"string","enum":["confirmed","tentative","cancelled"]},"title":{"type":"string"},"description":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"meetLink":{"type":"string","nullable":true},"htmlLink":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"organizer":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true}},"required":["email","name"],"additionalProperties":false,"nullable":true},"attendees":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true},"responseStatus":{"type":"string","nullable":true},"self":{"type":"boolean"},"organizer":{"type":"boolean"}},"required":["email"],"additionalProperties":false}},"recurringEventId":{"type":"string","nullable":true},"recurrenceRule":{"type":"string","nullable":true},"isRecurring":{"type":"boolean"},"createdByUserId":{"type":"string","nullable":true},"remindersEnabled":{"type":"boolean"},"busy":{"type":"boolean","enum":[false]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"personId":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"]},"status":{"type":"string","enum":["confirmed","suggested","dismissed"]},"clientResponse":{"type":"string","enum":["confirmed","reschedule_requested"],"nullable":true},"createdByUserId":{"type":"string","nullable":true},"createdAt":{"type":"string"},"conversation":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true}},"required":["id"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","eventId","conversationId","personId","source","status","clientResponse","createdByUserId","createdAt"],"additionalProperties":false}}},"required":["id","calendarId","isAllDay","startAt","endAt","startDate","endDate","status","title","description","location","meetLink","htmlLink","timezone","organizer","attendees","recurringEventId","recurrenceRule","isRecurring","createdByUserId","remindersEnabled","busy","createdAt","updatedAt"],"additionalProperties":false},"description":"Início >= agora, em ordem crescente."},"past":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string"},"isAllDay":{"type":"boolean"},"startAt":{"type":"string","nullable":true},"endAt":{"type":"string","nullable":true},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"status":{"type":"string","enum":["confirmed","tentative","cancelled"]},"title":{"type":"string"},"description":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"meetLink":{"type":"string","nullable":true},"htmlLink":{"type":"string","nullable":true},"timezone":{"type":"string","nullable":true},"organizer":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true}},"required":["email","name"],"additionalProperties":false,"nullable":true},"attendees":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"},"name":{"type":"string","nullable":true},"responseStatus":{"type":"string","nullable":true},"self":{"type":"boolean"},"organizer":{"type":"boolean"}},"required":["email"],"additionalProperties":false}},"recurringEventId":{"type":"string","nullable":true},"recurrenceRule":{"type":"string","nullable":true},"isRecurring":{"type":"boolean"},"createdByUserId":{"type":"string","nullable":true},"remindersEnabled":{"type":"boolean"},"busy":{"type":"boolean","enum":[false]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"links":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"eventId":{"type":"string"},"conversationId":{"type":"string","nullable":true},"personId":{"type":"string","nullable":true},"source":{"type":"string","enum":["manual","created_in_conversation","auto_email","suggested_phone"]},"status":{"type":"string","enum":["confirmed","suggested","dismissed"]},"clientResponse":{"type":"string","enum":["confirmed","reschedule_requested"],"nullable":true},"createdByUserId":{"type":"string","nullable":true},"createdAt":{"type":"string"},"conversation":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true}},"required":["id"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","eventId","conversationId","personId","source","status","clientResponse","createdByUserId","createdAt"],"additionalProperties":false}}},"required":["id","calendarId","isAllDay","startAt","endAt","startDate","endDate","status","title","description","location","meetLink","htmlLink","timezone","organizer","attendees","recurringEventId","recurrenceRule","isRecurring","createdByUserId","remindersEnabled","busy","createdAt","updatedAt"],"additionalProperties":false},"description":"Já iniciados, do mais recente ao mais antigo."}},"required":["upcoming","past"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/conversations/{conversationId}/compose-defaults":{"get":{"summary":"Rascunho do evento ao agendar pela conversa","tags":["Calendar"],"description":"Título, duração, participantes, vínculos e agenda sugeridos para o compositor aberto de dentro de uma conversa. O evento em si é criado por `POST /calendar/events`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"conversationId","required":true,"description":"ID da conversa."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"durationMinutes":{"type":"integer"},"attendees":{"type":"array","items":{"type":"string"},"description":"E-mail do contato, se houver."},"links":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"conversationId":{"type":"string"}},"required":["conversationId"],"additionalProperties":false},{"type":"object","properties":{"personId":{"type":"string"}},"required":["personId"],"additionalProperties":false}]}},"calendarId":{"type":"string","description":"Última agenda usada com escrita, senão a agenda interna do usuário."},"remindersDefault":{"type":"boolean","description":"Sugestão do switch de lembretes (escritório ativou e há contato)."}},"required":["title","durationMinutes","attendees","links","calendarId","remindersDefault"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/settings":{"get":{"summary":"Configuração da Agenda do escritório","tags":["Calendar"],"description":"Fuso e lembretes por WhatsApp do escritório.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string","description":"Fuso IANA usado nos lembretes."},"remindersEnabled":{"type":"boolean"},"reminderOffsets":{"type":"array","items":{"type":"integer"},"description":"Frequência padrão dos lembretes, em minutos antes do início."},"reminderMessageText":{"type":"string","nullable":true,"description":"Texto do lembrete nos canais sem template; nulo = padrão."},"freeTextSupported":{"type":"boolean","description":"Há integração sem template (não é a API Oficial): o front mostra o texto."},"agentCalendarId":{"type":"string","nullable":true,"description":"Agenda onde o agente de IA marca reuniões; nula = módulo antigo."},"agentCalendar":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"provider":{"type":"string","enum":["internal","google"]},"ownerName":{"type":"string","nullable":true}},"required":["id","name","provider","ownerName"],"additionalProperties":false,"nullable":true},"attendanceConfirmationEnabled":{"type":"boolean","description":"Em cada evento, marcar se compareceu ou não (tarefas ficam de fora)."},"attendanceConfirmationInboxIds":{"type":"array","items":{"type":"string"},"description":"Workspaces onde a confirmação vale; vazio = todos."}},"required":["timezone","remindersEnabled","reminderOffsets","reminderMessageText","freeTextSupported","agentCalendarId","agentCalendar","attendanceConfirmationEnabled","attendanceConfirmationInboxIds"],"additionalProperties":false}}}}}},"put":{"summary":"Atualizar configuração da Agenda (Gestor)","tags":["Calendar"],"description":"Fuso, regras de lembrete, agenda do agente de IA e confirmação de comparecimento. Gestor ou `manage:calendar`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string","minLength":1,"description":"Fuso IANA, ex.: `America/Sao_Paulo`."},"remindersEnabled":{"type":"boolean"},"reminderOffsets":{"type":"array","items":{"type":"integer"},"maxItems":3,"description":"Minutos antes do início: 1440 (1 dia), 60 (1 hora) e/ou 30."},"reminderMessageText":{"type":"string","maxLength":1000,"nullable":true,"description":"Texto do lembrete nos canais sem template; vazio ou nulo = padrão."},"agentCalendarId":{"type":"string","minLength":1,"nullable":true,"description":"Agenda do agente de IA (escrita exigida); `null` desliga."},"attendanceConfirmationEnabled":{"type":"boolean"},"attendanceConfirmationInboxIds":{"type":"array","items":{"type":"string","minLength":1},"maxItems":200,"description":"Workspaces onde a confirmação vale. Valem os do escritório a que quem grava tem acesso (os que ele não vê continuam); com todos, grava vazio = todos, inclusive os criados depois. Lista sem nenhum válido responde 400."}},"additionalProperties":false}}}},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string","description":"Fuso IANA usado nos lembretes."},"remindersEnabled":{"type":"boolean"},"reminderOffsets":{"type":"array","items":{"type":"integer"},"description":"Frequência padrão dos lembretes, em minutos antes do início."},"reminderMessageText":{"type":"string","nullable":true,"description":"Texto do lembrete nos canais sem template; nulo = padrão."},"freeTextSupported":{"type":"boolean","description":"Há integração sem template (não é a API Oficial): o front mostra o texto."},"agentCalendarId":{"type":"string","nullable":true,"description":"Agenda onde o agente de IA marca reuniões; nula = módulo antigo."},"agentCalendar":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"provider":{"type":"string","enum":["internal","google"]},"ownerName":{"type":"string","nullable":true}},"required":["id","name","provider","ownerName"],"additionalProperties":false,"nullable":true},"attendanceConfirmationEnabled":{"type":"boolean","description":"Em cada evento, marcar se compareceu ou não (tarefas ficam de fora)."},"attendanceConfirmationInboxIds":{"type":"array","items":{"type":"string"},"description":"Workspaces onde a confirmação vale; vazio = todos."}},"required":["timezone","remindersEnabled","reminderOffsets","reminderMessageText","freeTextSupported","agentCalendarId","agentCalendar","attendanceConfirmationEnabled","attendanceConfirmationInboxIds"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/me/preferences":{"get":{"summary":"Preferências do usuário na Agenda","tags":["Calendar"],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"lastView":{"type":"string","enum":["day","week","month","list"],"nullable":true},"lastUsedCalendarId":{"type":"string","nullable":true}},"required":["lastView","lastUsedCalendarId"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"put":{"summary":"Atualizar preferências do usuário na Agenda","tags":["Calendar"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"lastView":{"type":"string","enum":["day","week","month","list"],"nullable":true},"lastUsedCalendarId":{"type":"string","minLength":1,"nullable":true,"description":"Agenda acessível ao usuário."}},"additionalProperties":false}}}},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"lastView":{"type":"string","enum":["day","week","month","list"],"nullable":true},"lastUsedCalendarId":{"type":"string","nullable":true}},"required":["lastView","lastUsedCalendarId"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/blocks":{"get":{"summary":"Listar bloqueios da agenda","tags":["Calendar"],"description":"Bloqueios ativos (semanais e por data até o último dia) de todas as agendas e das agendas que o usuário lê. Primeiro os por data (início), depois os semanais.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string","nullable":true,"description":"`null` = todas as agendas."},"calendarName":{"type":"string","nullable":true,"description":"Agenda interna: nome do dono; Google: nome da agenda."},"calendarColor":{"type":"string","nullable":true},"kind":{"type":"string","enum":["date","weekly"]},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"weekdays":{"type":"array","items":{"type":"number"}},"allDay":{"type":"boolean"},"startTime":{"type":"string","nullable":true},"endTime":{"type":"string","nullable":true},"reason":{"type":"string","nullable":true},"canDelete":{"type":"boolean"},"createdAt":{"type":"string"}},"required":["id","calendarId","calendarName","calendarColor","kind","startDate","endDate","weekdays","allDay","startTime","endTime","reason","canDelete","createdAt"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}}}},"post":{"summary":"Criar bloqueio da agenda","tags":["Calendar"],"description":"O agente de IA não marca reuniões no período; a equipe só é avisada. Todas as agendas exigem `manage:calendar`; uma agenda, escrita nela. Datas e horas no fuso do escritório. 422 para data passada e acima de 200 bloqueios ativos.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"calendarId":{"type":"string","minLength":1,"nullable":true,"description":"Agenda bloqueada; `null` = todas as agendas (exige `manage:calendar`)."},"kind":{"type":"string","enum":["date","weekly"],"description":"`date`: data específica ou período; `weekly`: toda semana."},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","format":"date","description":"`date`: primeiro dia (YYYY-MM-DD)."},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","format":"date","description":"`date`: último dia, inclusive (YYYY-MM-DD). Omitido = `startDate`."},"weekdays":{"type":"array","items":{"type":"integer","minimum":1,"maximum":7},"description":"`weekly`: dias ISO (1 = segunda ... 7 = domingo)."},"allDay":{"type":"boolean"},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","description":"Sem `allDay`: início (HH:mm)."},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","description":"Sem `allDay`: fim (HH:mm), depois do início."},"reason":{"type":"string","maxLength":120,"nullable":true,"description":"Motivo (opcional). Nunca vai para o agente de IA."}},"required":["calendarId","kind","allDay"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"calendarId":{"type":"string","nullable":true,"description":"`null` = todas as agendas."},"calendarName":{"type":"string","nullable":true,"description":"Agenda interna: nome do dono; Google: nome da agenda."},"calendarColor":{"type":"string","nullable":true},"kind":{"type":"string","enum":["date","weekly"]},"startDate":{"type":"string","nullable":true},"endDate":{"type":"string","nullable":true},"weekdays":{"type":"array","items":{"type":"number"}},"allDay":{"type":"boolean"},"startTime":{"type":"string","nullable":true},"endTime":{"type":"string","nullable":true},"reason":{"type":"string","nullable":true},"canDelete":{"type":"boolean"},"createdAt":{"type":"string"}},"required":["id","calendarId","calendarName","calendarColor","kind","startDate","endDate","weekdays","allDay","startTime","endTime","reason","canDelete","createdAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/blocks/occurrences":{"get":{"summary":"Bloqueios no intervalo da grade","tags":["Calendar"],"description":"Bloqueios visíveis ao usuário expandidos no intervalo (até 100 dias): uma ocorrência por dia por bloqueio, ordenadas pelo início. Entram as que cruzam o intervalo. Agenda que o usuário só vê como livre/ocupado entra sem o motivo.","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"start","required":true,"description":"Início do intervalo (ISO)."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"end","required":true,"description":"Fim do intervalo (ISO, exclusivo)."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"blockId":{"type":"string"},"calendarId":{"type":"string","nullable":true},"reason":{"type":"string","nullable":true,"description":"`null` sem motivo ou em agenda que o usuário só vê como livre/ocupado."},"allDay":{"type":"boolean"},"date":{"type":"string","description":"Dia da ocorrência (YYYY-MM-DD) no fuso do escritório."},"startAt":{"type":"string"},"endAt":{"type":"string"}},"required":["blockId","calendarId","reason","allDay","date","startAt","endAt"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/blocks/{id}":{"delete":{"summary":"Excluir bloqueio da agenda","tags":["Calendar"],"description":"Mesma regra de criar, pelo alvo do bloqueio.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do bloqueio."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"],"nullable":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/events/{id}/nps":{"get":{"summary":"Pesquisa NPS do evento","tags":["Calendar"],"description":"Config da agenda, contatos vinculados e a pesquisa de cada um (sem o token). Abaixo de `reader` responde 404.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do evento."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Config da agenda ligada e capaz de enviar."},"autoOnAttended":{"type":"boolean","description":"Marcar \"Compareceu\" agora dispara a pesquisa (automático ligado, não cancelado, nos últimos 7 dias, contato vinculado sem pesquisa)."},"invalidReason":{"type":"string","description":"Por que não envia (desligada, sem integração...)."},"hasContact":{"type":"boolean","description":"Há contato vinculado; sem ele o botão pede \"Vincule um contato ou conversa\"."},"cancelled":{"type":"boolean"},"contacts":{"type":"array","items":{"type":"object","properties":{"personId":{"type":"string","nullable":true,"description":"Nulo se o contato foi excluído."},"name":{"type":"string"},"survey":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["scheduled","sent","failed","answered","skipped"]},"failureReason":{"type":"string","enum":["no_phone","contact_blocked","integration_disconnected","number_not_on_whatsapp","template_not_approved","integration_removed","attendance_changed","send_error"],"nullable":true},"error":{"type":"string","description":"Detalhe técnico da falha."},"trigger":{"type":"string","enum":["auto","manual"]},"scheduledFor":{"type":"string","nullable":true},"sentAt":{"type":"string","nullable":true,"description":"Último envio."},"sendCount":{"type":"integer"},"expiresAt":{"type":"string","nullable":true,"description":"Primeiro envio + 30 dias."},"expired":{"type":"boolean"},"answeredAt":{"type":"string","nullable":true},"score":{"type":"integer","nullable":true},"comment":{"type":"string","nullable":true}},"required":["id","status","failureReason","trigger","scheduledFor","sentAt","sendCount","expiresAt","expired","answeredAt","score","comment"],"additionalProperties":false,"nullable":true}},"required":["personId","name","survey"],"additionalProperties":false}}},"required":["enabled","autoOnAttended","hasContact","cancelled","contacts"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Disparar a pesquisa NPS do evento","tags":["Calendar"],"description":"Sai no próximo minuto, sem janela de horário. Sem pesquisa cria; enviada, com falha ou pulada reenvia com o mesmo link; respondida fica. 409: config desligada ou inválida, evento cancelado, sem contato vinculado ou link expirado. `edit:calendar-event` e escrita na agenda.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"personIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":100,"description":"Contatos vinculados que recebem; omitido = todos."}},"additionalProperties":false,"default":{}}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID do evento."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Config da agenda ligada e capaz de enviar."},"autoOnAttended":{"type":"boolean","description":"Marcar \"Compareceu\" agora dispara a pesquisa (automático ligado, não cancelado, nos últimos 7 dias, contato vinculado sem pesquisa)."},"invalidReason":{"type":"string","description":"Por que não envia (desligada, sem integração...)."},"hasContact":{"type":"boolean","description":"Há contato vinculado; sem ele o botão pede \"Vincule um contato ou conversa\"."},"cancelled":{"type":"boolean"},"contacts":{"type":"array","items":{"type":"object","properties":{"personId":{"type":"string","nullable":true,"description":"Nulo se o contato foi excluído."},"name":{"type":"string"},"survey":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["scheduled","sent","failed","answered","skipped"]},"failureReason":{"type":"string","enum":["no_phone","contact_blocked","integration_disconnected","number_not_on_whatsapp","template_not_approved","integration_removed","attendance_changed","send_error"],"nullable":true},"error":{"type":"string","description":"Detalhe técnico da falha."},"trigger":{"type":"string","enum":["auto","manual"]},"scheduledFor":{"type":"string","nullable":true},"sentAt":{"type":"string","nullable":true,"description":"Último envio."},"sendCount":{"type":"integer"},"expiresAt":{"type":"string","nullable":true,"description":"Primeiro envio + 30 dias."},"expired":{"type":"boolean"},"answeredAt":{"type":"string","nullable":true},"score":{"type":"integer","nullable":true},"comment":{"type":"string","nullable":true}},"required":["id","status","failureReason","trigger","scheduledFor","sentAt","sendCount","expiresAt","expired","answeredAt","score","comment"],"additionalProperties":false,"nullable":true}},"required":["personId","name","survey"],"additionalProperties":false}}},"required":["enabled","autoOnAttended","hasContact","cancelled","contacts"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/nps/results":{"get":{"summary":"Notas NPS do período (painel da Visão estratégica)","tags":["Calendar"],"description":"Uma linha por pesquisa já enviada de evento que o usuário lê no período: só o evento e a nota. O painel junta com as calls que mostra e agrupa por responsável.","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"start","required":true,"description":"Início do período (ISO)."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"end","required":true,"description":"Fim do período (ISO, exclusivo)."},{"schema":{"type":"string","minLength":1},"in":"query","name":"inboxId","required":false,"description":"Workspace atual, como no list-events."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"configured":{"type":"boolean","description":"Alguma agenda do escritório tem a pesquisa ligada."},"surveys":{"type":"array","items":{"type":"object","properties":{"eventId":{"type":"string"},"score":{"type":"integer","nullable":true,"description":"`null` = enviada sem resposta."}},"required":["eventId","score"],"additionalProperties":false}}},"required":["configured","surveys"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/nps/settings":{"get":{"summary":"Configuração da pesquisa NPS","tags":["Calendar"],"description":"Agendas que o usuário acessa com a config de NPS de cada uma, integrações de WhatsApp do escritório e o template de NPS vivo de cada WABA. `manage:calendar`.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"attendanceConfirmationEnabled":{"type":"boolean","description":"Sem a confirmação de comparecimento, o automático nunca dispara."},"frontendUrlConfigured":{"type":"boolean"},"calendars":{"type":"array","items":{"type":"object","properties":{"calendarId":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"provider":{"type":"string","enum":["internal","google"]},"ownerName":{"type":"string","nullable":true},"settings":{"type":"object","properties":{"enabled":{"type":"boolean"},"autoSendOnAttended":{"type":"boolean"},"integrationId":{"type":"string","nullable":true},"liteMessageText":{"type":"string","nullable":true}},"required":["enabled","autoSendOnAttended","integrationId","liteMessageText"],"additionalProperties":false,"nullable":true},"valid":{"type":"boolean","description":"Falso quando a config ligada não consegue enviar."},"invalidReason":{"type":"string"}},"required":["calendarId","name","color","provider","ownerName","settings","valid"],"additionalProperties":false}},"integrations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"inboxId":{"type":"string"},"inboxName":{"type":"string","description":"Workspace da integração (a tela agrupa por ele)."},"channel":{"type":"string","enum":["lite_whatsapp","whatsapp"]},"connected":{"type":"boolean"},"wabaId":{"type":"string","nullable":true}},"required":["id","name","inboxId","inboxName","channel","connected","wabaId"],"additionalProperties":false}},"templates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"wabaId":{"type":"string"},"integrationId":{"type":"string","nullable":true},"name":{"type":"string","description":"`nps_agendamento_v{n}` ou `lembrete_agendamento_v{n}`"},"status":{"type":"string","enum":["pending","approved","rejected","paused","disabled"]},"category":{"type":"string","description":"Categoria final da Meta; MARKETING não é erro."},"rejectionReason":{"type":"string","nullable":true},"lastSyncedAt":{"type":"string","nullable":true},"bodyText":{"type":"string"}},"required":["id","wabaId","integrationId","name","status","category","rejectionReason","lastSyncedAt","bodyText"],"additionalProperties":false},"description":"O template vivo (o mais recente) de cada WABA."}},"required":["attendanceConfirmationEnabled","frontendUrlConfigured","calendars","integrations","templates"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/nps/settings/{calendarId}":{"put":{"summary":"Salvar a pesquisa NPS de uma agenda","tags":["Calendar"],"description":"Ligada exige integração do escritório (Starter ou API Oficial; a Oficial com WABA). Starter: texto com `{link_pesquisa}` ou `null` (padrão). `manage:calendar`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"autoSendOnAttended":{"type":"boolean","default":true,"description":"Enviar sozinho quando o agendamento for marcado como comparecido."},"integrationId":{"type":"string","minLength":1,"nullable":true,"description":"Integração do escritório, WhatsApp Starter ou API Oficial."},"liteMessageText":{"type":"string","maxLength":1000,"nullable":true,"description":"Starter: texto com placeholders; `{link_pesquisa}` é obrigatório. `null` = padrão."}},"required":["enabled"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"calendarId","required":true,"description":"ID da agenda."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"attendanceConfirmationEnabled":{"type":"boolean","description":"Sem a confirmação de comparecimento, o automático nunca dispara."},"frontendUrlConfigured":{"type":"boolean"},"calendars":{"type":"array","items":{"type":"object","properties":{"calendarId":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"provider":{"type":"string","enum":["internal","google"]},"ownerName":{"type":"string","nullable":true},"settings":{"type":"object","properties":{"enabled":{"type":"boolean"},"autoSendOnAttended":{"type":"boolean"},"integrationId":{"type":"string","nullable":true},"liteMessageText":{"type":"string","nullable":true}},"required":["enabled","autoSendOnAttended","integrationId","liteMessageText"],"additionalProperties":false,"nullable":true},"valid":{"type":"boolean","description":"Falso quando a config ligada não consegue enviar."},"invalidReason":{"type":"string"}},"required":["calendarId","name","color","provider","ownerName","settings","valid"],"additionalProperties":false}},"integrations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"inboxId":{"type":"string"},"inboxName":{"type":"string","description":"Workspace da integração (a tela agrupa por ele)."},"channel":{"type":"string","enum":["lite_whatsapp","whatsapp"]},"connected":{"type":"boolean"},"wabaId":{"type":"string","nullable":true}},"required":["id","name","inboxId","inboxName","channel","connected","wabaId"],"additionalProperties":false}},"templates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"wabaId":{"type":"string"},"integrationId":{"type":"string","nullable":true},"name":{"type":"string","description":"`nps_agendamento_v{n}` ou `lembrete_agendamento_v{n}`"},"status":{"type":"string","enum":["pending","approved","rejected","paused","disabled"]},"category":{"type":"string","description":"Categoria final da Meta; MARKETING não é erro."},"rejectionReason":{"type":"string","nullable":true},"lastSyncedAt":{"type":"string","nullable":true},"bodyText":{"type":"string"}},"required":["id","wabaId","integrationId","name","status","category","rejectionReason","lastSyncedAt","bodyText"],"additionalProperties":false},"description":"O template vivo (o mais recente) de cada WABA."}},"required":["attendanceConfirmationEnabled","frontendUrlConfigured","calendars","integrations","templates"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/nps/templates":{"post":{"summary":"Criar o template de NPS na Meta","tags":["Calendar"],"description":"Idempotente: com template PENDING ou APPROVED na WABA, devolve o existente. Com o vivo recusado, pausado ou desativado, cria `nps_agendamento_v{n+1}` (UTILITY, pt_BR, botão com o link da pesquisa). Nada é gravado se a Meta recusar. `manage:calendar`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"integrationId":{"type":"string","minLength":1,"description":"Integração da API Oficial."},"bodyText":{"type":"string","description":"BODY com {{1}} (primeiro nome), {{2}} (escritório) e {{3}} (data)."}},"required":["integrationId","bodyText"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"wabaId":{"type":"string"},"integrationId":{"type":"string","nullable":true},"name":{"type":"string","description":"`nps_agendamento_v{n}` ou `lembrete_agendamento_v{n}`"},"status":{"type":"string","enum":["pending","approved","rejected","paused","disabled"]},"category":{"type":"string","description":"Categoria final da Meta; MARKETING não é erro."},"rejectionReason":{"type":"string","nullable":true},"lastSyncedAt":{"type":"string","nullable":true},"bodyText":{"type":"string"}},"required":["id","wabaId","integrationId","name","status","category","rejectionReason","lastSyncedAt","bodyText"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/calendar/nps/templates/{id}/sync":{"post":{"summary":"Atualizar o status do template de NPS","tags":["Calendar"],"description":"Consulta a Meta: status, categoria final e motivo da recusa.","parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true,"description":"ID do template de NPS."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"wabaId":{"type":"string"},"integrationId":{"type":"string","nullable":true},"name":{"type":"string","description":"`nps_agendamento_v{n}` ou `lembrete_agendamento_v{n}`"},"status":{"type":"string","enum":["pending","approved","rejected","paused","disabled"]},"category":{"type":"string","description":"Categoria final da Meta; MARKETING não é erro."},"rejectionReason":{"type":"string","nullable":true},"lastSyncedAt":{"type":"string","nullable":true},"bodyText":{"type":"string"}},"required":["id","wabaId","integrationId","name","status","category","rejectionReason","lastSyncedAt","bodyText"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/templates/{integrationId}":{"get":{"summary":"Listar templates de WhatsApp","tags":["Templates"],"description":"Retorna os templates de mensagem cadastrados na WABA vinculada à integração. Apenas templates com status `APPROVED` podem ser enviados em conversas.","parameters":[{"schema":{"allOf":[{"anyOf":[{"not":{}},{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}]},{"anyOf":[{"not":{}},{"type":"array","items":{"type":"string","enum":["APPROVED","PENDING","REJECTED","PAUSED"],"description":"Status de aprovação do template na Meta. Apenas templates APPROVED podem ser enviados."}}]}]},"in":"query","name":"status","required":false,"description":"Filtra por status, separados por vírgula. Ex.: APPROVED,PENDING. Sem o filtro, retorna todos."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"integrationId","required":true,"description":"ID da integração de WhatsApp API Oficial do escritório."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nome do template na Meta, em letras minúsculas."},"status":{"anyOf":[{"type":"string","enum":["APPROVED","PENDING","REJECTED","PAUSED"],"description":"Status de aprovação do template na Meta. Apenas templates APPROVED podem ser enviados."},{"type":"string"}],"description":"Status de aprovação do template na Meta."},"category":{"type":"string","description":"Categoria do template: UTILITY, MARKETING ou AUTHENTICATION."},"language":{"type":"string","description":"Código do idioma do template, ex.: pt_BR."},"components":{"type":"array","items":{"type":"object","additionalProperties":{}},"description":"Componentes do template (HEADER, BODY, FOOTER e BUTTONS)."},"id":{"type":"string","description":"ID do template na Meta. Use-o para atualizar o template."}},"required":["name","status","category","language","components","id"],"additionalProperties":false},"description":"Templates cadastrados na WABA."}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Criar template de WhatsApp","tags":["Templates"],"description":"Submete um novo template à aprovação da Meta. A análise não é instantânea: o template nasce com status `PENDING` e só pode ser enviado após virar `APPROVED`. Cabeçalhos de mídia exigem o handle devolvido por `POST /integration/templates/{integrationId}/media` em `example.header_handle`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":512,"pattern":"^[a-z0-9_]+$","description":"Nome único do template. Apenas letras minúsculas, números e underscores, ex.: retorno_atendimento."},"category":{"type":"string","enum":["UTILITY","MARKETING","AUTHENTICATION"],"description":"Categoria declarada à Meta. AUTHENTICATION exige botão OTP e corpo com aviso de segurança."},"language":{"type":"string","minLength":2,"description":"Código do idioma do template, ex.: pt_BR."},"components":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["HEADER","BODY","FOOTER","BUTTONS"],"description":"Tipo do componente. BODY é obrigatório em todo template."},"format":{"type":"string","enum":["TEXT","IMAGE","VIDEO","DOCUMENT","LOCATION"],"description":"Formato do cabeçalho. Aplicável somente a componentes HEADER."},"text":{"type":"string","description":"Conteúdo textual do componente. Use {{1}}, {{2}} para variáveis posicionais."},"example":{"type":"object","properties":{"header_text":{"type":"array","items":{"type":"array","items":{"type":"string"}},"description":"Exemplos das variáveis do cabeçalho de texto."},"header_handle":{"type":"array","items":{"type":"string"},"description":"Handle da mídia devolvido por POST /integration/templates/{integrationId}/media. Obrigatório em cabeçalhos IMAGE, VIDEO ou DOCUMENT."},"body_text":{"type":"array","items":{"type":"array","items":{"type":"string"}},"description":"Exemplos das variáveis do corpo. Gerados automaticamente quando omitidos."}},"additionalProperties":true,"description":"Exemplos exigidos pela Meta para aprovar o template."},"buttons":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["QUICK_REPLY"]},"text":{"type":"string","minLength":1,"maxLength":25,"description":"Rótulo do botão (até 25 caracteres)."}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["URL"]},"text":{"type":"string","minLength":1,"maxLength":25,"description":"Rótulo do botão (até 25 caracteres)."},"url":{"type":"string","format":"uri","description":"URL de destino. Pode conter a variável {{1}} no final do caminho."},"example":{"type":"array","items":{"type":"string"},"description":"Exemplos de URL completa quando a URL contém variável."}},"required":["type","text","url"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["PHONE_NUMBER"]},"text":{"type":"string","minLength":1,"maxLength":25,"description":"Rótulo do botão (até 25 caracteres)."},"phone_number":{"type":"string","minLength":8,"description":"Telefone no formato internacional, ex.: +5511999999999."}},"required":["type","text","phone_number"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["OTP"]},"otp_type":{"type":"string","enum":["COPY_CODE","ONE_TAP"],"description":"Forma de entrega do código: copiar código ou toque único."},"text":{"type":"string","minLength":1,"maxLength":25,"description":"Rótulo do botão (até 25 caracteres)."}},"required":["type","otp_type","text"],"additionalProperties":false}],"description":"Botão do template. QUICK_REPLY não pode ser combinado com URL/PHONE_NUMBER na mesma mensagem."},"description":"Botões do componente BUTTONS. Máximo de 3 QUICK_REPLY ou 2 URL/PHONE_NUMBER."},"add_security_recommendation":{"type":"boolean","description":"Adiciona o aviso de segurança padrão. Somente em templates AUTHENTICATION."},"code_expiration_minutes":{"type":"integer","minimum":1,"maximum":90,"description":"Validade do código OTP em minutos (1 a 90). Somente em AUTHENTICATION."}},"required":["type"],"additionalProperties":false},"minItems":1,"description":"Componentes do template. Ao menos um componente BODY é obrigatório."}},"required":["name","category","language","components"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"integrationId","required":true,"description":"ID da integração de WhatsApp API Oficial do escritório."}],"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do template na Meta."},"status":{"type":"string","description":"Status inicial atribuído pela Meta, normalmente PENDING."},"category":{"type":"string","description":"Categoria confirmada pela Meta."},"success":{"type":"boolean","description":"Indica sucesso em operações de exclusão."}},"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/templates/{integrationId}/media":{"post":{"summary":"Enviar mídia do cabeçalho de template","tags":["Templates"],"description":"Faz upload de uma mídia para a Meta e devolve o handle usado em cabeçalhos IMAGE, VIDEO ou DOCUMENT. Envie como `multipart/form-data` com os campos `file` (arquivo) e `type` (image, video ou document). O handle é obrigatório ao criar um template com cabeçalho de mídia.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"integrationId","required":true,"description":"ID da integração de WhatsApp API Oficial do escritório."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"Handle da mídia na Meta. Informe-o em example.header_handle ao criar ou atualizar o template."}},"required":["handle"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/templates/{integrationId}/{templateId}":{"patch":{"summary":"Atualizar template de WhatsApp","tags":["Templates"],"description":"Altera os componentes de um template existente. Nome, categoria e idioma não podem ser alterados — para mudá-los, crie um novo template. Toda edição envia o template para nova análise da Meta.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"components":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["HEADER","BODY","FOOTER","BUTTONS"],"description":"Tipo do componente. BODY é obrigatório em todo template."},"format":{"type":"string","enum":["TEXT","IMAGE","VIDEO","DOCUMENT","LOCATION"],"description":"Formato do cabeçalho. Aplicável somente a componentes HEADER."},"text":{"type":"string","description":"Conteúdo textual do componente. Use {{1}}, {{2}} para variáveis posicionais."},"example":{"type":"object","properties":{"header_text":{"type":"array","items":{"type":"array","items":{"type":"string"}},"description":"Exemplos das variáveis do cabeçalho de texto."},"header_handle":{"type":"array","items":{"type":"string"},"description":"Handle da mídia devolvido por POST /integration/templates/{integrationId}/media. Obrigatório em cabeçalhos IMAGE, VIDEO ou DOCUMENT."},"body_text":{"type":"array","items":{"type":"array","items":{"type":"string"}},"description":"Exemplos das variáveis do corpo. Gerados automaticamente quando omitidos."}},"additionalProperties":true,"description":"Exemplos exigidos pela Meta para aprovar o template."},"buttons":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["QUICK_REPLY"]},"text":{"type":"string","minLength":1,"maxLength":25,"description":"Rótulo do botão (até 25 caracteres)."}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["URL"]},"text":{"type":"string","minLength":1,"maxLength":25,"description":"Rótulo do botão (até 25 caracteres)."},"url":{"type":"string","format":"uri","description":"URL de destino. Pode conter a variável {{1}} no final do caminho."},"example":{"type":"array","items":{"type":"string"},"description":"Exemplos de URL completa quando a URL contém variável."}},"required":["type","text","url"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["PHONE_NUMBER"]},"text":{"type":"string","minLength":1,"maxLength":25,"description":"Rótulo do botão (até 25 caracteres)."},"phone_number":{"type":"string","minLength":8,"description":"Telefone no formato internacional, ex.: +5511999999999."}},"required":["type","text","phone_number"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["OTP"]},"otp_type":{"type":"string","enum":["COPY_CODE","ONE_TAP"],"description":"Forma de entrega do código: copiar código ou toque único."},"text":{"type":"string","minLength":1,"maxLength":25,"description":"Rótulo do botão (até 25 caracteres)."}},"required":["type","otp_type","text"],"additionalProperties":false}],"description":"Botão do template. QUICK_REPLY não pode ser combinado com URL/PHONE_NUMBER na mesma mensagem."},"description":"Botões do componente BUTTONS. Máximo de 3 QUICK_REPLY ou 2 URL/PHONE_NUMBER."},"add_security_recommendation":{"type":"boolean","description":"Adiciona o aviso de segurança padrão. Somente em templates AUTHENTICATION."},"code_expiration_minutes":{"type":"integer","minimum":1,"maximum":90,"description":"Validade do código OTP em minutos (1 a 90). Somente em AUTHENTICATION."}},"required":["type"],"additionalProperties":false},"minItems":1,"description":"Nova lista de componentes. Substitui integralmente a anterior."}},"required":["components"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"integrationId","required":true,"description":"ID da integração de WhatsApp API Oficial do escritório."},{"schema":{"type":"string","minLength":1},"in":"path","name":"templateId","required":true,"description":"ID do template na Meta, devolvido na listagem ou na criação."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do template na Meta."},"status":{"type":"string","description":"Status inicial atribuído pela Meta, normalmente PENDING."},"category":{"type":"string","description":"Categoria confirmada pela Meta."},"success":{"type":"boolean","description":"Indica sucesso em operações de exclusão."}},"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/integration/templates/{integrationId}/{templateName}":{"delete":{"summary":"Excluir template de WhatsApp","tags":["Templates"],"description":"Remove o template da WABA pelo nome. A exclusão é definitiva e apaga todas as versões de idioma registradas sob esse nome. Mensagens já enviadas não são afetadas.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"integrationId","required":true,"description":"ID da integração de WhatsApp API Oficial do escritório."},{"schema":{"type":"string","minLength":1},"in":"path","name":"templateName","required":true,"description":"Nome do template na Meta. A exclusão remove todos os idiomas desse nome."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do template na Meta."},"status":{"type":"string","description":"Status inicial atribuído pela Meta, normalmente PENDING."},"category":{"type":"string","description":"Categoria confirmada pela Meta."},"success":{"type":"boolean","description":"Indica sucesso em operações de exclusão."}},"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/":{"get":{"summary":"Listar conversas","tags":["Conversations"],"description":"Lista conversas da inbox com filtros por status, prioridade, canal, tags, texto e aguardando resposta. Pagine com `limit` e o `nextCursor` da resposta (em `cursor`); `page` continua aceito, mas repete ou pula conversa quando a lista muda entre as páginas.","parameters":[{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"page","required":false,"description":"Número da página."},{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"limit","required":false,"description":"Quantidade de itens por página."},{"schema":{"type":"string"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox. Obrigatório para filtrar as conversas."},{"schema":{"type":"string"},"in":"query","name":"content","required":false,"description":"Filtra por nome, telefone ou grupo. Com 3+ caracteres, também busca no texto das mensagens."},{"schema":{"type":"boolean"},"in":"query","name":"searchMessages","required":false,"description":"Quando falso, `content` busca só no nome, telefone ou grupo, sem o texto das mensagens. Padrão: verdadeiro."},{"schema":{"type":"string"},"in":"query","name":"tags","required":false,"description":"Filtra por tags (IDs separados por vírgula ou outro formato aceito)."},{"schema":{"anyOf":[{"type":"string","enum":["all"]},{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"}}]},"in":"query","name":"integrationId","required":false,"description":"Filtra por canal de integração. Pode ser `all`, um ID ou uma lista de IDs."},{"schema":{"anyOf":[{"type":"string","enum":["ROBOT_INTERACTIVE","INACTIVE","HUMAN_INTERACTIVE","WAITING_HUMAN","PAUSED"]},{"type":"string","enum":["FLOW_INTERACTIVE"]}]},"in":"query","name":"status","required":false,"description":"Filtra pelo status da conversa. `FLOW_INTERACTIVE` lista as conversas com fluxo em andamento; `WAITING_HUMAN` lista só a fila humana (sem fluxo)."},{"schema":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"in":"query","name":"priority","required":false,"description":"Filtra pela prioridade da conversa."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"userId","required":false,"description":"Filtra pelo ID do usuário responsável."},{"schema":{"type":"string"},"in":"query","name":"departmentId","required":false,"description":"Filtra pelo ID do departamento responsável pela conversa."},{"schema":{"type":"boolean"},"in":"query","name":"assignedToMe","required":false,"description":"Quando verdadeiro, retorna apenas as conversas atribuídas ao usuário logado ou aos departamentos dele."},{"schema":{"type":"boolean"},"in":"query","name":"showOnlyUnread","required":false,"description":"Quando verdadeiro, retorna apenas conversas com mensagens não lidas."},{"schema":{"type":"boolean"},"in":"query","name":"showGroups","required":false,"description":"Quando verdadeiro, inclui conversas de grupo."},{"schema":{"type":"boolean"},"in":"query","name":"onlyGroups","required":false,"description":"Quando verdadeiro, retorna apenas conversas de grupo."},{"schema":{"type":"boolean"},"in":"query","name":"onlyPrivate","required":false,"description":"Quando verdadeiro, retorna apenas conversas individuais (1:1)."},{"schema":{"type":"boolean"},"in":"query","name":"awaitingReply","required":false,"description":"Quando verdadeiro, retorna conversas cuja última mensagem é INBOUND. Se nenhum status for informado, exclui INACTIVE."},{"schema":{"type":"boolean"},"in":"query","name":"onlyArchived","required":false,"description":"Quando verdadeiro, retorna apenas conversas arquivadas."},{"schema":{"type":"string","enum":["newest","oldest"],"default":"newest"},"in":"query","name":"sortOrder","required":false,"description":"Ordem da lista pela data da última mensagem: `newest` (mais recentes primeiro, padrão) ou `oldest` (mais antigas primeiro). Conversas fixadas e prioridade continuam vindo antes em ambos os casos."},{"schema":{"type":"string","maxLength":512},"in":"query","name":"cursor","required":false,"description":"Cursor opaco devolvido em `nextCursor`. Quando presente, `page` é ignorado e a lista continua logo depois do último item da página anterior — sem repetir nem pular conversa se a lista mudou entre as páginas. Use o mesmo `sortOrder` e os mesmos filtros da página que o gerou."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da conversa."},"status":{"type":"string","enum":["ROBOT_INTERACTIVE","INACTIVE","HUMAN_INTERACTIVE","WAITING_HUMAN","PAUSED"],"description":"Status atual da conversa."},"inFlow":{"type":"boolean","description":"Fluxo em andamento atendendo a conversa (status WAITING_HUMAN com sessão de fluxo)."},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"description":"Prioridade da conversa."},"isFixed":{"type":"boolean","description":"Indica se a conversa está fixada na inbox."},"isGroup":{"type":"boolean","description":"Indica se é uma conversa de grupo."},"isPrivate":{"type":"boolean","description":"Indica se é uma conversa individual (1:1)."},"isArchived":{"type":"boolean","description":"Indica se a conversa está arquivada."},"isMuted":{"type":"boolean","description":"Estado efetivo do silenciamento — já considera um mute expirado como falso."},"muteScope":{"type":"string","enum":["JURICHAT","JURICHAT_AND_WHATSAPP"],"nullable":true,"description":"Escopo escolhido ao silenciar."},"mutedUntil":{"type":"string","format":"date-time","nullable":true,"description":"Quando o silêncio expira. Null com isMuted=true é permanente."},"responsables":{"type":"array","items":{"type":"string"},"description":"IDs dos usuários responsáveis pela conversa."},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"imageUrl":{"type":"string","nullable":true},"phoneNumber":{"type":"string","nullable":true},"externalIdentitySource":{"type":"string","enum":["WEB_CHAT","INSTAGRAM"],"nullable":true},"externalIdentityId":{"type":"string","nullable":true},"isPersonal":{"type":"boolean","description":"Contato pessoal: fora das métricas e sem IA, fluxo ou automação."}},"required":["id","name","imageUrl","phoneNumber","isPersonal"],"additionalProperties":false,"nullable":true,"description":"Contato vinculado à conversa individual. Null para grupos."},"group":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"externalId":{"type":"string"},"imageUrl":{"type":"string","nullable":true}},"required":["id","name","externalId","imageUrl"],"additionalProperties":false,"nullable":true,"description":"Dados do grupo. Null para conversas individuais."},"lastMessage":{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string","nullable":true},"type":{"type":"string"},"direction":{"type":"string","description":"Direção da última mensagem: INBOUND (cliente) ou OUTBOUND (atendente/IA)."},"messageAt":{"type":"string"},"userId":{"type":"string","nullable":true},"userName":{"type":"string","nullable":true},"isViewedBySameUserLastMessage":{"type":"boolean"}},"additionalProperties":false,"description":"Resumo da última mensagem. Omitido se não houver mensagens."},"user":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"imageUrl":{"type":"string","nullable":true}},"required":["id","name","imageUrl"],"additionalProperties":false,"nullable":true,"description":"Atendente atribuído à conversa. Null se não atribuído."},"formattedDate":{"type":"string","nullable":true,"description":"Data formatada para exibição."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."},"unreadCount":{"type":"number","nullable":true,"description":"Quantidade de mensagens não lidas. Null se não calculado."},"scheduledMessagesCount":{"type":"number","description":"Quantidade de mensagens agendadas pendentes vinculadas à conversa."},"departments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"description":"Departamentos atribuídos à conversa (até 5)."},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false},"description":"Tags associadas à conversa."},"inbox":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"description":"Inbox à qual a conversa pertence."},"integration":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"channel":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"description":"Canal de integração da conversa."},"legalArea":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false,"nullable":true,"description":"Área jurídica associada à conversa. Null se não atribuída."}},"required":["id","status","inFlow","priority","isFixed","isGroup","isPrivate","isArchived","isMuted","muteScope","mutedUntil","responsables","person","group","user","formattedDate","createdAt","updatedAt","unreadCount","scheduledMessagesCount","departments","tags","inbox","integration","legalArea"],"additionalProperties":false}},"totalResults":{"type":"number","description":"Total de registros encontrados."},"totalPages":{"type":"number","description":"Total de páginas para a quantidade solicitada."},"nextCursor":{"type":"string","nullable":true,"description":"Cursor da próxima página (enviar em `cursor`). Null quando não há mais conversas."}},"required":["data","totalResults","totalPages","nextCursor"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Criar conversa","tags":["Conversations"],"description":"Cria uma conversa individual com o contato informado ou devolve a que já existe para o contato no mesmo canal.\n\nCom API key a conversa existente é sempre devolvida como está, mesmo em atendimento humano; `departmentIds` só precisa ser de setores do escritório, vale só para a conversa nova, e nada é deduzido nem atribuído.\n\nNo painel (JWT), conversa em atendimento com outro usuário responde 409 com os nomes do cliente e do atendente e, quando quem pede pode abrir essa conversa, `details.conversationId`. Quem só enxerga as conversas do próprio setor pode iniciar sem informar `departmentIds`: com um setor ele é deduzido; nos demais casos a conversa nova fica atribuída ao próprio usuário. Para esse usuário, a conversa existente sem setor e sem responsável passa a ser dele; a que está fora do alcance dele (de outro setor, ou sem setor e de outro responsável) responde 409 em vez de devolver o id, salvo atendimento encerrado e não privado com a permissão `start:closed-conversation`, que passa para os setores informados ou deduzidos (sem setor, para ele) e é devolvido. A conversa existente dentro do alcance dele volta como está.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"personId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do contato vinculado à conversa, da inbox informada."},"inboxId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da inbox onde a conversa será criada."},"integrationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do canal de integração (WhatsApp, web chat etc.), da inbox informada."},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"description":"Aceito e ignorado hoje: a conversa nova nasce com a prioridade padrão (`LOW`) e a existente mantém a dela."},"departmentIds":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":5,"description":"IDs dos setores da conversa nova (máx. 5); a existente devolvida mantém os dela, salvo o atendimento encerrado que o restrito assume (ver a descrição). No painel (JWT), para usuário restrito, os setores informados precisam ser dele; sem seleção inequívoca, a conversa nova fica atribuída ao próprio usuário. Com API key basta o setor ser do escritório: nada é deduzido nem atribuído."}},"required":["personId","inboxId","integrationId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"conversation":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa criada ou existente reutilizada."}},"required":["id"],"additionalProperties":false},"person":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do contato."},"name":{"type":"string","description":"Nome do contato."}},"required":["id","name"],"additionalProperties":false}},"required":["conversation","person"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/counters":{"get":{"summary":"Contadores de conversas","tags":["Conversations"],"description":"Retorna os contadores dos filtros rápidos e de cada status (total, minhas, aguardando, aguardando resposta, em atendimento, atendimento por IA, atendimento por fluxo e encerradas) para os filtros aplicados na listagem.","parameters":[{"schema":{"type":"string"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox. Obrigatório para filtrar as conversas."},{"schema":{"type":"string"},"in":"query","name":"content","required":false,"description":"Filtra por nome, telefone ou grupo. Com 3+ caracteres, também busca no texto das mensagens."},{"schema":{"type":"boolean"},"in":"query","name":"searchMessages","required":false,"description":"Quando falso, `content` busca só no nome, telefone ou grupo, sem o texto das mensagens. Padrão: verdadeiro."},{"schema":{"type":"string"},"in":"query","name":"tags","required":false,"description":"Filtra por tags (IDs separados por vírgula ou outro formato aceito)."},{"schema":{"anyOf":[{"type":"string","enum":["all"]},{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"}}]},"in":"query","name":"integrationId","required":false,"description":"Filtra por canal de integração. Pode ser `all`, um ID ou uma lista de IDs."},{"schema":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"in":"query","name":"priority","required":false,"description":"Filtra pela prioridade da conversa."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"userId","required":false,"description":"Filtra pelo ID do usuário responsável."},{"schema":{"type":"string"},"in":"query","name":"departmentId","required":false,"description":"Filtra pelo ID do departamento responsável pela conversa."},{"schema":{"type":"boolean"},"in":"query","name":"showOnlyUnread","required":false,"description":"Quando verdadeiro, retorna apenas conversas com mensagens não lidas."},{"schema":{"type":"boolean"},"in":"query","name":"showGroups","required":false,"description":"Quando verdadeiro, inclui conversas de grupo."},{"schema":{"type":"boolean"},"in":"query","name":"onlyGroups","required":false,"description":"Quando verdadeiro, retorna apenas conversas de grupo."},{"schema":{"type":"boolean"},"in":"query","name":"onlyPrivate","required":false,"description":"Quando verdadeiro, retorna apenas conversas individuais (1:1)."},{"schema":{"type":"boolean"},"in":"query","name":"onlyArchived","required":false,"description":"Quando verdadeiro, retorna apenas conversas arquivadas."},{"schema":{"type":"string","maxLength":512},"in":"query","name":"cursor","required":false,"description":"Cursor opaco devolvido em `nextCursor`. Quando presente, `page` é ignorado e a lista continua logo depois do último item da página anterior — sem repetir nem pular conversa se a lista mudou entre as páginas. Use o mesmo `sortOrder` e os mesmos filtros da página que o gerou."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"number","description":"Total de conversas que atendem aos filtros aplicados."},"mine":{"type":"number","description":"Conversas atribuídas ao usuário logado ou aos departamentos dele."},"waiting":{"type":"number","description":"Conversas na fila humana (WAITING_HUMAN sem fluxo em andamento)."},"awaitingReply":{"type":"number","description":"Conversas cuja última mensagem é INBOUND, em qualquer status exceto INACTIVE."},"human":{"type":"number","description":"Conversas em atendimento humano (HUMAN_INTERACTIVE)."},"robot":{"type":"number","description":"Conversas em atendimento por IA (ROBOT_INTERACTIVE)."},"flow":{"type":"number","description":"Conversas em atendimento por fluxo (FLOW_INTERACTIVE)."},"closed":{"type":"number","description":"Conversas encerradas (INACTIVE)."}},"required":["total","mine","waiting","awaitingReply","human","robot","flow","closed"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/live-overview":{"get":{"summary":"Visão ao vivo dos atendimentos em andamento","tags":["Conversations"],"description":"Retorna os atendimentos em andamento (HUMAN_INTERACTIVE/WAITING_HUMAN) da inbox informada, agrupados por setor e por atendente.","parameters":[{"schema":{"type":"string"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox. Escopo obrigatório da visão ao vivo."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"departments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"ongoingCount":{"type":"number"}},"required":["id","name","ongoingCount"],"additionalProperties":false},"description":"Contagem de atendimentos em andamento por setor/fila."},"agents":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string"},"name":{"type":"string"},"imageUrl":{"type":"string","nullable":true},"conversations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true},"personImageUrl":{"type":"string","nullable":true},"departments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"status":{"type":"string"},"updatedAt":{"type":"string","format":"date-time"},"unreadCount":{"type":"number"},"lastMessage":{"type":"object","properties":{"content":{"type":"string","nullable":true},"type":{"type":"string"},"direction":{"type":"string","nullable":true},"messageAt":{"type":"string","format":"date-time"}},"required":["content","type","direction","messageAt"],"additionalProperties":false,"nullable":true}},"required":["id","personName","personImageUrl","departments","status","updatedAt","unreadCount","lastMessage"],"additionalProperties":false}}},"required":["userId","name","imageUrl","conversations"],"additionalProperties":false},"description":"Atendimentos em andamento agrupados por atendente."},"unassigned":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"personName":{"type":"string","nullable":true},"personImageUrl":{"type":"string","nullable":true},"departments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"status":{"type":"string"},"updatedAt":{"type":"string","format":"date-time"},"unreadCount":{"type":"number"},"lastMessage":{"type":"object","properties":{"content":{"type":"string","nullable":true},"type":{"type":"string"},"direction":{"type":"string","nullable":true},"messageAt":{"type":"string","format":"date-time"}},"required":["content","type","direction","messageAt"],"additionalProperties":false,"nullable":true}},"required":["id","personName","personImageUrl","departments","status","updatedAt","unreadCount","lastMessage"],"additionalProperties":false},"description":"Atendimentos em andamento sem atendente atribuído, do mais antigo para o mais recente."}},"required":["departments","agents","unassigned"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/attendance-report/stream":{"post":{"summary":"Relatório de atendimentos do período via SSE","tags":["Conversations"],"description":"Atendimentos (passagens por fila/atendimento humano) que cruzam o período, reconstruídos do histórico de status, com linhas e indicadores.\nSó o que o histórico registrou: início, fim e duração ficam nulos quando não há registro.\nO progresso é transmitido como `text/event-stream`.\n\nEventos:\n- `progress`: `{ phase, processed, total, percent }` — `phase` ∈ conversations | events | building.\n- `done`: o relatório completo (`period`, `generatedAt`, `historyStartsAt`, `rowLimit`, `truncated`, `rows`, `summary`).\n- `error`: `{ message }` — o relatório falhou (por exemplo, atendimentos demais no período); o stream é encerrado em seguida.\n\nLinhas iniciadas por `:` são heartbeats. Fechar a conexão cancela a geração.\nErros de validação (400), sem a permissão do relatório de atendimentos ou setor fora do escopo (403), inbox sem acesso (404) ou relatório já em andamento (409) voltam como JSON antes do stream abrir.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"inboxId":{"type":"string","description":"ID da inbox do relatório."},"start":{"type":"string","format":"date-time","description":"Primeiro dia do período (ISO 8601, meia-noite local)."},"end":{"type":"string","format":"date-time","description":"Último dia do período (ISO 8601, meia-noite local); o dia inteiro entra."},"departmentId":{"type":"string","description":"Só atendimentos deste setor."},"userId":{"type":"string","description":"Só atendimentos deste responsável."},"status":{"type":"string","enum":["ROBOT_INTERACTIVE","INACTIVE","HUMAN_INTERACTIVE","WAITING_HUMAN","PAUSED"],"description":"Situação atual da conversa."},"integrationId":{"type":"string","description":"Só este canal (integração)."},"type":{"type":"string","enum":["ONGOING","QUEUE","CLOSED"],"description":"ONGOING: em andamento; QUEUE: em fila; CLOSED: encerrado."}},"required":["inboxId","start","end"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Stream text/event-stream com o progresso.","content":{"application/json":{"schema":{"description":"Stream text/event-stream com o progresso."}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/notes":{"get":{"summary":"Listar notas","tags":["Conversations"],"description":"Lista notas internas da conversa, com autor quando disponível.","parameters":[{"schema":{"type":"string"},"in":"query","name":"conversationId","required":true,"description":"ID da conversa cujas notas serão listadas."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da nota."},"content":{"type":"string","description":"Texto da nota."},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fileName":{"type":"string"},"mediaType":{"type":"string"},"fileExtension":{"type":"string"}},"required":["id","fileName","mediaType","fileExtension"],"additionalProperties":false},"description":"Arquivos privados vinculados à nota."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"user":{"type":"object","properties":{"id":{"type":"string","description":"ID do autor."},"name":{"type":"string","description":"Nome do autor."},"imageUrl":{"type":"string","nullable":true,"description":"URL de avatar do autor. Null se não definido."}},"required":["id","name","imageUrl"],"additionalProperties":false,"nullable":true,"description":"Autor da nota. Null se criado pelo sistema."}},"required":["id","content","attachments","createdAt","user"],"additionalProperties":false}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/{conversationId}/whatsapp-window":{"get":{"summary":"Status da janela WhatsApp oficial","tags":["Conversations"],"description":"Retorna o status da janela de mensagens para WhatsApp API Oficial e Instagram Direct.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"conversationId","required":true}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"isOfficialWhatsapp":{"type":"boolean"},"isInstagram":{"type":"boolean"},"isWindowExpired":{"type":"boolean"},"requiresTemplate":{"type":"boolean"},"windowStatus":{"type":"string","enum":["open","awaiting_client_response","template_required","window_closed","human_agent_only"]},"integrationId":{"type":"string","nullable":true},"channel":{"type":"string","description":"Canal da conversa (LITE_WHATSAPP, WHATSAPP, INSTAGRAM, WEB_CHAT...)."},"instagramReply":{"type":"object","properties":{"canSendDirect":{"type":"boolean","description":"Direct livre ou Direct privado do comentário ainda disponível."},"canReplyToComment":{"type":"boolean","description":"Dá para responder em público no comentário do post."},"privateReplyAvailable":{"type":"boolean","description":"Ainda cabe o único Direct privado deste comentário (7 dias)."},"commentId":{"type":"string","nullable":true},"defaultTarget":{"type":"string","enum":["direct","comment"]}},"required":["canSendDirect","canReplyToComment","privateReplyAvailable","commentId","defaultTarget"],"additionalProperties":false,"nullable":true}},"required":["isOfficialWhatsapp","isInstagram","isWindowExpired","requiresTemplate","windowStatus","integrationId","channel","instagramReply"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/media-library":{"get":{"summary":"Galeria de mídia do escritório","tags":["Conversations"],"description":"Lista somente imagens e vídeos enviados manualmente para a galeria do escritório autenticado. Mídias de conversas não alimentam este acervo.","parameters":[{"schema":{"allOf":[{"type":"string","maxLength":320},{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"minItems":1,"maxItems":5}]},"in":"query","name":"folder","required":false},{"schema":{"type":"string","minLength":1,"maxLength":2048},"in":"query","name":"cursor","required":false,"description":"Token da próxima página devolvido pelo storage."},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false,"description":"Itens por página. Padrão 24, máximo 100."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador opaco do arquivo na galeria."},"category":{"type":"string","enum":["image","video"]},"uploadedAt":{"type":"string","format":"date-time"},"url":{"type":"string","description":"URL assinada para visualizar o arquivo."},"fileName":{"type":"string"},"mimeType":{"type":"string","enum":["image/jpeg","image/png","video/mp4"]},"folder":{"allOf":[{"type":"string","maxLength":320},{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"minItems":1,"maxItems":5}],"nullable":true},"tags":{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":30,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"maxItems":10}},"required":["id","category","uploadedAt","url","fileName","mimeType","folder","tags"],"additionalProperties":false}},"folders":{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"description":"Pastas da raiz, na ordem salva. Igual em qualquer pasta aberta."},"subfolders":{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"description":"Subpastas diretas da pasta aberta, na ordem salva."},"nextCursor":{"type":"string","nullable":true}},"required":["data","folders","subfolders","nextCursor"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Adicionar mídia à galeria","tags":["Conversations"],"description":"Recebe `multipart/form-data` com `file`. Aceita JPEG, PNG ou MP4 e salva no acervo do escritório autenticado.","security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador opaco do arquivo na galeria."},"category":{"type":"string","enum":["image","video"]},"uploadedAt":{"type":"string","format":"date-time"},"url":{"type":"string","description":"URL assinada para visualizar o arquivo."},"fileName":{"type":"string"},"mimeType":{"type":"string","enum":["image/jpeg","image/png","video/mp4"]},"folder":{"allOf":[{"type":"string","maxLength":320},{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"minItems":1,"maxItems":5}],"nullable":true},"tags":{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":30,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"maxItems":10}},"required":["id","category","uploadedAt","url","fileName","mimeType","folder","tags"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir mídia da galeria","tags":["Conversations"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"mediaId":{"type":"string","minLength":1,"maxLength":2048}},"required":["mediaId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/media-library/send":{"post":{"summary":"Enviar mídia da galeria","tags":["Conversations"],"description":"Envia para uma conversa autorizada um arquivo do acervo do escritório autenticado.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"Conversa de destino, para onde o arquivo será enviado."},"mediaId":{"type":"string","minLength":1,"maxLength":1024,"description":"Identificador do arquivo salvo na galeria."},"caption":{"type":"string","maxLength":1024,"description":"Legenda opcional do envio."}},"required":["conversationId","mediaId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/media-library/folders":{"post":{"summary":"Criar pasta na galeria","tags":["Conversations"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"parent":{"allOf":[{"type":"string","maxLength":320},{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"minItems":1,"maxItems":5}],"nullable":true,"description":"Pasta onde a nova pasta é criada. Ausente ou `null` cria na raiz."}},"required":["name"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"folder":{"allOf":[{"type":"string","maxLength":320},{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"minItems":1,"maxItems":5}]}},"required":["name","folder"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir pasta vazia da galeria","tags":["Conversations"],"description":"Remove somente a pasta vazia. Pastas com mídias retornam conflito e preservam todo o conteúdo.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"folder":{"allOf":[{"type":"string","maxLength":320},{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"minItems":1,"maxItems":5}]}},"required":["folder"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/media-library/tags":{"patch":{"summary":"Atualizar etiquetas da mídia","tags":["Conversations"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"mediaId":{"type":"string","minLength":1,"maxLength":2048},"tags":{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":30,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"maxItems":10}},"required":["mediaId","tags"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":30,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"maxItems":10}},"required":["tags"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/media-library/move":{"patch":{"summary":"Mover mídia entre pastas","tags":["Conversations"],"description":"Move a mídia para outra pasta, ou para a raiz com `folder: null`, sem duplicar o arquivo. Conteúdo, etiquetas e data de envio são preservados; o `id` devolvido substitui o anterior porque acompanha o caminho no storage.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"mediaId":{"type":"string","minLength":1,"maxLength":2048},"folder":{"allOf":[{"type":"string","maxLength":320},{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"minItems":1,"maxItems":5}],"nullable":true,"description":"Pasta de destino. `null` move para a raiz da galeria."}},"required":["mediaId","folder"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"folder":{"allOf":[{"type":"string","maxLength":320},{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"minItems":1,"maxItems":5}],"nullable":true}},"required":["id","folder"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/media-library/folders/tree":{"get":{"summary":"Listar todas as pastas da galeria","tags":["Conversations"],"description":"Caminho de todas as pastas do escritório, até 1.000.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"folders":{"type":"array","items":{"allOf":[{"type":"string","maxLength":320},{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"minItems":1,"maxItems":5}]}}},"required":["folders"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/media-library/folders/move":{"patch":{"summary":"Mover pasta da galeria","tags":["Conversations"],"description":"Move a pasta, com mídias e subpastas, para outra pasta ou para a raiz com `parent: null`. Até 1.000 arquivos por operação. Mídias mudam de `id` porque acompanham o caminho no storage.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"folder":{"allOf":[{"type":"string","maxLength":320},{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"minItems":1,"maxItems":5}]},"parent":{"allOf":[{"type":"string","maxLength":320},{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"minItems":1,"maxItems":5}],"nullable":true,"description":"Pasta de destino. `null` move para a raiz da galeria."}},"required":["folder","parent"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"folder":{"allOf":[{"type":"string","maxLength":320},{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"minItems":1,"maxItems":5}]}},"required":["folder"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/media-library/folders/order":{"put":{"summary":"Ordenar pastas da galeria","tags":["Conversations"],"description":"Salva a ordem de exibição das subpastas de `parent`. Pastas fora da lista aparecem depois, em ordem alfabética.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"parent":{"allOf":[{"type":"string","maxLength":320},{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"minItems":1,"maxItems":5}],"nullable":true,"description":"Pasta cujas subpastas são ordenadas. `null` é a raiz."},"order":{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"maxItems":1000}},"required":["parent","order"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"order":{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":60,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]}}},"required":["order"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/media-library/tag-catalog":{"get":{"summary":"Listar etiquetas da galeria","tags":["Conversations"],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"array","items":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":30,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]}}},"required":["tags"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Criar etiqueta da galeria","tags":["Conversations"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":30,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]}},"required":["name"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":30,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]}},"required":["name"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Renomear etiqueta da galeria","tags":["Conversations"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tag":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":30,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]},"name":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":30,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]}},"required":["tag","name"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":30,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]}},"required":["name"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir etiqueta da galeria","tags":["Conversations"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tag":{"allOf":[{"type":"string"},{"type":"string","minLength":1,"maxLength":30,"pattern":"^[\\p{L}\\p{N}](?:[\\p{L}\\p{N} _-]*[\\p{L}\\p{N}])?$"}]}},"required":["tag"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/{conversationId}/messages/search":{"get":{"summary":"Buscar mensagens na conversa","tags":["Conversations"],"description":"Busca mensagens da conversa cujo conteúdo contém o termo informado, ordenadas cronologicamente.","parameters":[{"schema":{"type":"string","minLength":3,"maxLength":100},"in":"query","name":"content","required":true,"description":"Termo buscado no conteúdo das mensagens da conversa."},{"schema":{"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false,"description":"Quantidade máxima de resultados. Padrão 50, máximo 100."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"conversationId","required":true,"description":"ID da conversa."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"messageId":{"type":"string"},"messageAt":{"type":"string","format":"date-time"},"type":{"type":"string","description":"Tipo da mensagem (text, image, audio, etc.)."},"snippet":{"type":"string","description":"Trecho legível da mensagem. Mídia aparece como rótulo + legenda/transcrição, nunca como URL."}},"required":["messageId","messageAt","type","snippet"],"additionalProperties":false}},"total":{"type":"number"},"hasMore":{"type":"boolean"}},"required":["data","total","hasMore"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/{conversationId}/whatsapp-number-check":{"get":{"summary":"Verificação do número no WhatsApp","tags":["Conversations"],"description":"Verifica na uazapi se o número do contato da conversa está registrado no WhatsApp. Aplica-se apenas a conversas do canal LITE_WHATSAPP; nos demais casos retorna NOT_APPLICABLE.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"conversationId","required":true}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["VALID","INVALID","UNKNOWN","NOT_APPLICABLE"]},"isInWhatsapp":{"type":"boolean","nullable":true},"checkedNumber":{"type":"string","nullable":true},"verifiedName":{"type":"string","nullable":true},"message":{"type":"string","nullable":true}},"required":["status","isInWhatsapp","checkedNumber","verifiedName","message"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/{conversationId}/template-header-media":{"post":{"summary":"Upload de mídia do cabeçalho de template","tags":["Conversations"],"description":"Faz upload de imagem, vídeo ou documento para uso no cabeçalho de envio de template WhatsApp.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"conversationId","required":true}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"storagePath":{"type":"string"},"url":{"type":"string"},"fileName":{"type":"string"}},"required":["storagePath","url","fileName"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/{conversationId}":{"get":{"summary":"Obter conversa","tags":["Conversations"],"description":"Retorna os dados de uma conversa com participantes, tags e mensagens. Use `cursor` e `limit` para paginar as mensagens.","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Cursor para buscar a próxima página de mensagens. Use o valor retornado em `nextCursor`."},{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"limit","required":false,"description":"Quantidade máxima de mensagens por página."},{"schema":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["true","false"]}]},"in":"query","name":"favoritesOnly","required":false},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"conversationId","required":true,"description":"ID da conversa."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["ROBOT_INTERACTIVE","INACTIVE","HUMAN_INTERACTIVE","WAITING_HUMAN","PAUSED"]},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"phoneNumber":{"type":"string","nullable":true},"imageUrl":{"type":"string","nullable":true},"isPersonal":{"type":"boolean","description":"Contato pessoal: fora das métricas e sem IA, fluxo ou automação."}},"required":["id","name","phoneNumber","imageUrl","isPersonal"],"additionalProperties":false,"nullable":true},"user":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"imageUrl":{"type":"string","nullable":true}},"required":["id","name","imageUrl"],"additionalProperties":false,"nullable":true},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false}},"participants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"imageUrl":{"type":"string","nullable":true},"phoneNumber":{"type":"string","nullable":true},"isAgent":{"type":"boolean"},"isMember":{"type":"boolean"}},"required":["id","name","isAgent","isMember"],"additionalProperties":false}},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"type":{"type":"string"},"isRead":{"type":"boolean"},"isFavorite":{"type":"boolean"},"metadata":{"nullable":true,"description":"Dados adicionais da mensagem (mídia, etc.). isRead não vive mais aqui."},"direction":{"type":"string"},"messageAt":{"type":"string","format":"date-time"},"externalId":{"type":"string","nullable":true},"externalStatus":{"type":"string","nullable":true},"errorMessage":{"type":"string","nullable":true},"participantId":{"type":"string","nullable":true},"formattedDate":{"type":"string","nullable":true},"contact":{"type":"object","properties":{"name":{"type":"string","nullable":true},"phoneNumber":{"type":"string","nullable":true}},"required":["name","phoneNumber"],"additionalProperties":false,"nullable":true},"quotedMessage":{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"formattedDate":{"type":"string"}},"required":["id","content","formattedDate"],"additionalProperties":false,"nullable":true},"transcription":{"type":"string","nullable":true},"summary":{"type":"string","nullable":true},"templateContent":{"type":"object","properties":{"templateName":{"type":"string"},"headerMedia":{"type":"object","properties":{"format":{"type":"string","enum":["IMAGE","VIDEO","DOCUMENT","LOCATION"]},"link":{"type":"string"},"filename":{"type":"string"},"latitude":{"type":"string"},"longitude":{"type":"string"},"name":{"type":"string"},"address":{"type":"string"}},"required":["format"],"additionalProperties":false}},"additionalProperties":false,"nullable":true,"description":"Metadados visuais de mensagens template WhatsApp. Presente quando type é template."}},"required":["id","content","type","isRead","direction","messageAt","externalId","externalStatus","errorMessage","participantId","formattedDate","contact","quotedMessage","transcription","summary"],"additionalProperties":false}},"isGroup":{"type":"boolean"},"group":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"externalId":{"type":"string"},"imageUrl":{"type":"string","nullable":true}},"required":["id","name","externalId","imageUrl"],"additionalProperties":false,"nullable":true},"inboxId":{"type":"string"},"firstMessageAt":{"type":"string","format":"date-time","nullable":true,"description":"Data/hora da primeira mensagem da conversa. Null se ainda não houve mensagem."},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","status","priority","person","user","tags","participants","messages","isGroup","group","inboxId","firstMessageAt","createdAt","updatedAt"],"additionalProperties":false},"nextCursor":{"type":"string","description":"Cursor para buscar a próxima página de mensagens. Presente apenas quando `hasMore` for verdadeiro."},"hasMore":{"type":"boolean","description":"Indica se há mais mensagens disponíveis além da página atual."}},"required":["data","hasMore"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Atualizar conversa","tags":["Conversations"],"description":"Atualização parcial: só os campos enviados são aplicados. Enviar `departmentIds` também tira o responsável da conversa, que volta para a fila do setor.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"isFixed":{"type":"boolean","description":"Quando verdadeiro, fixa a conversa na inbox. Quando falso, desafixa."},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"description":"Nova prioridade da conversa."},"tags":{"type":"array","items":{"type":"string"},"description":"IDs das etiquetas. Substitui todas as etiquetas da conversa quando enviado; id repetido conta uma vez e etiqueta de outro escritório recusa o pedido com 404. A etiqueta ativa em Conversas e CRM que entra ou sai também entra ou sai dos cards de CRM e das outras conversas não privadas do contato, salvo quando esta conversa é privada: aí a troca fica só nela."},"departmentIds":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":5,"description":"IDs dos departamentos responsáveis pela fila (máx. 5)."},"agentId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","nullable":true,"description":"ID do agente de IA vinculado à conversa. Enviar `null` para remover o vínculo."},"legalAreaId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","nullable":true,"description":"ID da área jurídica vinculada à conversa. Enviar `null` para remover o vínculo."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"conversationId","required":true,"description":"ID da conversa."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Confirmação da operação.","content":{"application/json":{"schema":{"type":"string","description":"Confirmação da operação."}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir conversa","tags":["Conversations"],"description":"Remove a conversa e suas mensagens associadas.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"conversationId","required":true,"description":"ID da conversa a ser excluída."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Mensagem de confirmação."}},"required":["message"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/{conversationId}/activities":{"get":{"summary":"Histórico de eventos da conversa","tags":["Conversations"],"description":"Retorna a timeline de eventos da conversa: status, responsável, setor, prioridade, tags, arquivamento, privacidade, área jurídica, início/fim de fluxo e de agente, e follow-up enviado.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"conversationId","required":true,"description":"ID da conversa."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"personId":{"type":"string","nullable":true},"type":{"type":"string","enum":["STATUS_CHANGED","RESPONSIBLE_CHANGED","DEPARTMENT_CHANGED","FLOW_STARTED","FLOW_FINISHED","AGENT_STARTED","AGENT_FINISHED","FOLLOWUP_SENT","PRIORITY_CHANGED","TAG_ADDED","TAG_REMOVED","ARCHIVED_CHANGED","LEGAL_AREA_CHANGED","PRIVATE_CHANGED","SCHEDULED_MESSAGE_CREATED","SCHEDULED_MESSAGE_CANCELLED","SCHEDULED_MESSAGE_SENT"]},"data":{"type":"object","additionalProperties":{},"description":"Payload do evento, formato varia por `type` (ex: STATUS_CHANGED tem fromStatus/toStatus, RESPONSIBLE_CHANGED tem fromUser/toUser, TAG_ADDED/TAG_REMOVED tem tag, etc)."},"source":{"type":"string","enum":["USER","SYSTEM","FLOW","AGENT","AUTOMATION"]},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true,"description":"Usuário que originou o evento. Null quando source não é USER."},"createdAt":{"type":"string","format":"date-time"}},"required":["id","personId","type","data","source","createdBy","createdAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/note":{"post":{"summary":"Criar nota interna","tags":["Conversations"],"description":"Insere nota privada visível aos operadores na conversa. Aceita JSON para notas sem arquivo e multipart/form-data para notas com anexos.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa."},"note":{"type":"string","default":"","description":"Texto da nota interna."}},"required":["conversationId"],"additionalProperties":false}},"multipart/form-data":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa."},"note":{"type":"string","default":"","description":"Texto da nota interna."}},"required":["conversationId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","description":"ID da conversa."},"type":{"type":"string","description":"Tipo do registro criado."},"id":{"type":"string","description":"ID da nota criada."},"userId":{"type":"string","nullable":true,"description":"ID do autor. Null se criado pelo sistema."},"content":{"description":"Conteúdo da nota."},"direction":{"type":"string","description":"Direção da mensagem (interno)."},"messageAt":{"type":"string","format":"date-time","description":"Data e hora da nota."},"metadata":{"nullable":true,"description":"Dados adicionais. Null se não houver."},"externalId":{"type":"string","nullable":true,"description":"ID externo. Null se não aplicável."},"externalStatus":{"type":"string","nullable":true,"description":"Status no canal externo. Null se não aplicável."}},"required":["conversationId","type","id","userId","direction","messageAt","externalId","externalStatus"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"411":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"413":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/start-human-support":{"post":{"summary":"Iniciar atendimento humano ou transferir","tags":["Conversations"],"description":"Transfere a conversa para atendimento humano. Permite atribuir a um atendente específico ou a um aleatório, com opção de notificar o contato.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa."},"departmentIds":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":5,"description":"IDs dos departamentos responsáveis pela fila (máx. 5). Opcional."},"selectedUserId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do atendente específico. Opcional."},"isRandom":{"type":"boolean","default":false,"description":"Quando verdadeiro, seleciona um atendente aleatório elegível. Padrão: false."},"notifyTransfer":{"type":"boolean","default":false,"description":"Quando verdadeiro, envia notificação de transferência ao contato. Padrão: false."},"templateName":{"type":"string","description":"Nome do template de mensagem WhatsApp para a notificação de transferência. Opcional."},"variables":{"type":"array","items":{"type":"string"},"description":"Variáveis do corpo do template, na ordem definida pelo canal. Opcional."},"bodyVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do corpo para templates com parâmetros nomeados. Opcional."},"headerVariables":{"type":"array","items":{"type":"string"},"description":"Variáveis do cabeçalho do template. Opcional."},"headerVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do cabeçalho para templates com parâmetros nomeados. Opcional."},"headerMedia":{"type":"object","properties":{"format":{"type":"string","enum":["IMAGE","VIDEO","DOCUMENT","LOCATION"]},"link":{"type":"string"},"filename":{"type":"string"},"latitude":{"anyOf":[{"type":"string"},{"type":"number"}]},"longitude":{"anyOf":[{"type":"string"},{"type":"number"}]},"name":{"type":"string"},"address":{"type":"string"}},"required":["format"],"additionalProperties":false,"description":"Mídia do cabeçalho do template (imagem, vídeo, documento ou localização). Opcional."},"buttonVariables":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0},"parameters":{"type":"array","items":{"type":"string"}},"parameterNames":{"type":"array","items":{"type":"string"}}},"required":["index","parameters"],"additionalProperties":false},"description":"Variáveis dos botões dinâmicos do template. Opcional."}},"required":["conversationId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indica se a operação foi concluída com sucesso."},"message":{"type":"string","description":"Mensagem adicional sobre o resultado. Opcional."}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/end-human-support":{"post":{"summary":"Encerrar atendimento humano","tags":["Conversations"],"description":"Encerra o atendimento humano e devolve a conversa para o fluxo automático.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa."}},"required":["conversationId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indica se o atendimento humano foi encerrado com sucesso."}},"required":["success"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/pause-support":{"post":{"summary":"Pausar atendimento","tags":["Conversations"],"description":"Pausa um atendimento humano em andamento. A conversa fica com status PAUSED, mantém o atendente responsável e deixa de contar nas métricas de TMR e TMA. Qualquer mensagem nova retoma o atendimento.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa."}},"required":["conversationId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indica se a conversa mudou de estado de pausa com sucesso."}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/resume-support":{"post":{"summary":"Retomar atendimento pausado","tags":["Conversations"],"description":"Retoma um atendimento pausado, devolvendo a conversa para \"Em atendimento\" com o mesmo atendente responsável.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa."}},"required":["conversationId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indica se a conversa mudou de estado de pausa com sucesso."}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/send-message":{"post":{"summary":"Enviar mensagem","tags":["Conversations"],"description":"Envia uma mensagem na conversa. O body deve ser enviado como `multipart/form-data`.\n\nEm conversas do canal `LITE_WHATSAPP`, o número do contato é verificado na uazapi antes do envio. Quando o número não está registrado no WhatsApp, a requisição é recusada com `400` e `code: WHATSAPP_NUMBER_NOT_FOUND` — nada é registrado e o telefone do contato precisa ser corrigido. Se a verificação não puder ser concluída (instância desconectada, uazapi indisponível), o envio segue normalmente.","requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"conversationId":{"description":"ID da conversa. Enviado como campo de formulário (`multipart/form-data`)."},"message":{"description":"Texto da mensagem ou conteúdo conforme o tipo."},"type":{"description":"Tipo da mensagem: `text`, `audio`, `image`, `video`, `document`, `contact` ou `template`."},"file":{"description":"Arquivo de mídia. Obrigatório para tipos de mídia."},"caption":{"description":"Legenda da mídia. Opcional."},"fileName":{"description":"Nome do arquivo para documentos. Opcional."},"showResponsibleName":{"description":"Quando verdadeiro, exibe o nome do atendente na mensagem enviada."},"replyMessageId":{"description":"ID da mensagem à qual esta é uma resposta. Opcional."},"contactName":{"description":"Nome do contato. Obrigatório quando `type` for `contact`."},"contactPhoneNumber":{"description":"Telefone do contato. Obrigatório quando `type` for `contact`."},"templateName":{"description":"Nome do template WhatsApp. Obrigatório quando `type` for `template`."},"variables":{"description":"Variáveis do template em JSON array ou lista separada por vírgula. Opcional."},"headerVariables":{"description":"Variáveis do cabeçalho do template em JSON array ou lista separada por vírgula. Opcional."},"headerVariableNames":{"description":"Nomes das variáveis do cabeçalho em JSON array. Opcional."},"headerMedia":{"description":"Mídia do cabeçalho do template em JSON. Ex: {\"format\":\"IMAGE\",\"link\":\"https://...\"}. Opcional."},"bodyVariableNames":{"description":"Nomes das variáveis do corpo em JSON array. Opcional."},"buttonVariables":{"description":"Variáveis de botões dinâmicos do template em JSON array. Ex: [{\"index\":0,\"parameters\":[\"valor\"]}]. Opcional."},"mentions":{"description":"Menções em grupos Lite: `all` para todos os membros, ou ids de membros separados por vírgula. Opcional."},"instagramReplyTarget":{"description":"Destino no Instagram: `direct` (Direct livre ou privado do comentário) ou `comment` (resposta pública). Opcional."}},"additionalProperties":false}}}},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indica se o envio foi aceito para processamento."}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/edit-message":{"post":{"summary":"Editar mensagem enviada","tags":["Conversations"],"description":"Edita uma mensagem de texto enviada pelo WhatsApp Lite dentro da janela permitida pelo WhatsApp.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa."},"messageId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da mensagem a ser editada."},"content":{"type":"string","minLength":1,"maxLength":4096,"description":"Novo conteúdo da mensagem."}},"required":["conversationId","messageId","content"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indica se a edição foi concluída com sucesso."},"messageId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID interno da mensagem editada."},"externalId":{"type":"string","description":"Novo ID da mensagem no WhatsApp."}},"required":["success","messageId","externalId"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/react-message":{"post":{"summary":"Reagir a uma mensagem","tags":["Conversations"],"description":"Envia, troca ou remove uma reação em uma mensagem no WhatsApp Lite (UAZAPI) ou na API Oficial.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa."},"messageId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID interno da mensagem alvo."},"emoji":{"type":"string","maxLength":16,"description":"Emoji da reação. Envie o mesmo emoji de novo para remover."}},"required":["conversationId","messageId","emoji"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indica se a reação foi aplicada no provedor."},"action":{"type":"string","enum":["added","replaced","removed"],"description":"Resultado do toggle da reação."},"emoji":{"type":"string","description":"Emoji persistido. Vazio quando a reação foi removida."},"messageId":{"type":"string","nullable":true,"description":"ID interno da mensagem de reação. Nulo quando removida."},"targetMessageId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID interno da mensagem alvo."},"targetExternalId":{"type":"string","description":"ID da mensagem no WhatsApp."}},"required":["success","action","emoji","messageId","targetMessageId","targetExternalId"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/remove-message":{"post":{"summary":"Remover mensagem","tags":["Conversations"],"description":"Apaga uma mensagem da conversa no JuriChat. No WhatsApp Lite, a mensagem enviada pelo escritório há até 48 horas, que chegou ao WhatsApp, também é apagada para o contato (`deletedOnWhatsapp: true`); nos demais casos a exclusão vale apenas no JuriChat. Em conversa da API Oficial do WhatsApp só registros internos (nota, ticket) podem ser apagados.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa."},"messageId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da mensagem a ser removida."}},"required":["conversationId","messageId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indica se a remoção foi concluída com sucesso."},"deletedOnWhatsapp":{"type":"boolean","description":"Indica se a mensagem também foi apagada no WhatsApp. Ausente quando a mensagem já estava apagada."}},"required":["success"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"504":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/forward-message":{"post":{"summary":"Encaminhar mensagens","tags":["Conversations"],"description":"Encaminha uma ou mais mensagens para uma ou mais conversas.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs das conversas de destino."},"messageId":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs das mensagens a serem encaminhadas."}},"required":["conversationId","messageId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indica se o encaminhamento foi concluído com sucesso."}},"required":["success"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/message/{messageId}/download":{"get":{"summary":"Baixar mídia da mensagem","tags":["Conversations"],"description":"Retorna uma URL temporária para baixar ou visualizar o arquivo da mensagem.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"attachmentId","required":false,"description":"ID do anexo quando o arquivo pertence a uma nota interna."},{"schema":{"type":"string","enum":["attachment","inline"],"default":"attachment"},"in":"query","name":"disposition","required":false,"description":"Define se o arquivo será baixado ou aberto para visualização."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"messageId","required":true,"description":"ID da mensagem cujo arquivo será baixado."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"downloadUrl":{"type":"string","format":"uri"}},"required":["downloadUrl"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/{conversationId}/documents/download":{"get":{"summary":"Baixar todos os documentos da conversa","tags":["Conversations"],"description":"Gera e transmite um arquivo ZIP com os documentos enviados e recebidos na conversa. Aceita recorte por período.","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"startDate","required":false,"description":"Início do período, instante ISO. Ausente = sem limite inferior."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"endDate","required":false,"description":"Fim do período, instante ISO. Ausente = sem limite superior."},{"schema":{"type":"boolean"},"in":"query","name":"withAiTitles","required":false,"description":"Renomeia cada documento com IA a partir dos metadados. Custa 1 crédito de IA por documento renomeado."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"conversationId","required":true,"description":"ID da conversa cujos documentos serão baixados."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Arquivo ZIP com os documentos da conversa.","content":{"application/json":{"schema":{"description":"Arquivo ZIP com os documentos da conversa."}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/{conversationId}/documents/juridiq":{"post":{"summary":"Anexar documentos da conversa na ficha do cliente no Juridiq","tags":["Conversations"],"description":"Sobe para a ficha do cliente no Juridiq o mesmo recorte de documentos que o download traria. Quando a ficha não pode ser resolvida com segurança, responde `needs-selection` sem enviar nada.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"withAiTitles":{"type":"boolean"},"startDate":{"type":"string","format":"date-time","description":"Início do período, instante ISO."},"endDate":{"type":"string","format":"date-time","description":"Fim do período, instante ISO."},"personId":{"type":"string","format":"uuid","description":"Ficha do cliente no Juridiq (uuid). Só é enviado quando a tela precisou perguntar."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"conversationId","required":true,"description":"ID da conversa cujos documentos serão anexados no Juridiq."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"status":{"type":"string","enum":["attached"]},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"attached":{"type":"integer","minimum":0},"aiTitles":{"type":"string","enum":["applied","skipped"]},"failed":{"type":"array","items":{"type":"object","properties":{"fileName":{"type":"string"},"reason":{"type":"string"}},"required":["fileName","reason"],"additionalProperties":false}}},"required":["status","person","attached","failed"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["needs-selection"]},"persons":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}}},"required":["status","persons"],"additionalProperties":false}]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/sync-messages":{"post":{"summary":"Sincronizar mensagens (WhatsApp)","tags":["Conversations"],"description":"Sincroniza o histórico de mensagens do WhatsApp para a conversa informada.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa cujo histórico do WhatsApp será sincronizado."}},"required":["conversationId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indica se a sincronização foi iniciada com sucesso."}},"required":["success"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/{conversationId}/archive":{"patch":{"summary":"Arquivar ou desarquivar conversa","tags":["Conversations"],"description":"Arquiva ou desarquiva a conversa conforme o valor de `isArchived`. Exige `archive:conversation` ou o perfil Gestor.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"isArchived":{"type":"boolean","description":"Quando verdadeiro, arquiva a conversa. Quando falso, desarquiva."}},"required":["isArchived"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"conversationId","required":true,"description":"ID da conversa."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Confirmação."}},"required":["message"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/conversation/{conversationId}/mute":{"patch":{"summary":"Silenciar ou reativar notificações da conversa","tags":["Conversations"],"description":"Silencia ou reativa as notificações da conversa. Com `scope: JURICHAT_AND_WHATSAPP` a mudança também é aplicada no WhatsApp (somente WhatsApp Lite); se a uazapi falhar, a mudança local é mantida e `whatsappSynced` volta falso. O escopo de WhatsApp só é recusado ao silenciar — ao reativar, a chamada é apenas pulada.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"isMuted":{"type":"boolean","description":"Quando verdadeiro, silencia. Quando falso, reativa."},"scope":{"type":"string","enum":["JURICHAT","JURICHAT_AND_WHATSAPP"],"description":"Onde o silenciamento vale. `JURICHAT_AND_WHATSAPP` só é aceito em conexões WhatsApp Lite."},"durationHours":{"anyOf":[{"type":"number","enum":[8]},{"type":"number","enum":[168]},{"type":"number","enum":[-1]}],"description":"Duração em horas: 8, 168 (uma semana) ou -1 (permanente)."}},"required":["isMuted","scope"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"conversationId","required":true,"description":"ID da conversa."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Confirmação."},"isMuted":{"type":"boolean"},"muteScope":{"type":"string","enum":["JURICHAT","JURICHAT_AND_WHATSAPP"],"description":"Onde o silenciamento vale. `JURICHAT_AND_WHATSAPP` só é aceito em conexões WhatsApp Lite.","nullable":true},"mutedUntil":{"type":"string","format":"date-time","nullable":true,"description":"Quando o silêncio expira. Null com isMuted=true é permanente."},"whatsappSynced":{"type":"boolean","description":"Se o WhatsApp recebeu o estado pedido (silenciar ou reativar). Falso no escopo JURICHAT, e também quando a uazapi recusou — a mudança local vale mesmo assim."}},"required":["message","isMuted","muteScope","mutedUntil","whatsappSynced"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/people/":{"get":{"summary":"Listar contatos","tags":["Contacts"],"description":"Lista contatos da inbox com filtros por nome, e-mail, bloqueio e tags. Use `page` e `limit` juntos para paginar; sem eles, retorna todos os registros.","parameters":[{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"page","required":false,"description":"Número da página."},{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"limit","required":false,"description":"Quantidade de itens por página."},{"schema":{"type":"string"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox. Obrigatório para filtrar os contatos."},{"schema":{"type":"string"},"in":"query","name":"name","required":false,"description":"Filtra por nome (parcial) ou por trecho do telefone quando o texto contiver números."},{"schema":{"type":"string","format":"email"},"in":"query","name":"email","required":false,"description":"Filtra por e-mail (correspondência parcial)."},{"schema":{"type":"boolean"},"in":"query","name":"isBlocked","required":false,"description":"Filtra por status de bloqueio: `true` ou `false`."},{"schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"in":"query","name":"tags","required":false,"description":"Filtra contatos que possuam ao menos uma das tags informadas (IDs)."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do contato."},"name":{"type":"string","description":"Nome do contato."},"email":{"type":"string","nullable":true,"description":"E-mail ou null."},"imageUrl":{"type":"string","nullable":true,"description":"URL de avatar ou null."},"phoneNumber":{"type":"string","nullable":true,"description":"Número de telefone. Null se não informado."},"document":{"type":"string","nullable":true,"description":"CPF, CNPJ ou outro documento. Null se não informado."},"description":{"type":"string","nullable":true,"description":"Anotações sobre o contato. Null se não informado."},"country":{"type":"string","nullable":true,"description":"País. Null se não informado."},"city":{"type":"string","nullable":true,"description":"Cidade. Null se não informado."},"isBlocked":{"type":"boolean","description":"Indica se o contato está bloqueado."},"isPersonal":{"type":"boolean","description":"Contato pessoal: fora das métricas e sem IA, fluxo ou automação."},"inboxId":{"type":"string","description":"ID da inbox à qual o contato pertence."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."},"conversationId":{"type":"string","nullable":true,"description":"ID da conversa vinculada ao contato. Null se não houver."},"externalIdentitySource":{"type":"string","enum":["WEB_CHAT","INSTAGRAM"],"nullable":true,"description":"Origem externa do contato quando não veio de telefone."},"externalIdentityId":{"type":"string","nullable":true,"description":"Identificador externo do contato (ex.: sessão do web chat)."},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da tag."},"name":{"type":"string","description":"Nome exibido (UI)."},"color":{"type":"string","description":"Cor no formato aceito pelo produto (ex.: hex)."}},"required":["id","name","color"],"additionalProperties":false},"description":"Tags associadas ao contato."}},"required":["id","name","email","imageUrl","phoneNumber","document","description","country","city","isBlocked","isPersonal","inboxId","createdAt","updatedAt","conversationId","tags"],"additionalProperties":false},"description":"Itens da página atual."},"totalResults":{"type":"number","description":"Total de registros encontrados."},"totalPages":{"type":"number","description":"Total de páginas para a quantidade solicitada."}},"required":["data","totalResults","totalPages"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Criar contato","tags":["Contacts"],"description":"Cria um novo contato vinculado à inbox informada. As tags devem existir na mesma inbox. Conflito de dados únicos retorna 409.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome do contato."},"phoneNumber":{"type":"string","description":"Número de telefone do contato."},"email":{"type":"string","description":"E-mail do contato. Opcional."},"document":{"type":"string","description":"CPF ou CNPJ. Aceita formato numérico ou alfanumérico (CNPJ). Opcional."},"description":{"type":"string","description":"Anotações sobre o contato. Opcional."},"country":{"type":"string","description":"País. Opcional."},"city":{"type":"string","description":"Cidade. Opcional."},"inboxId":{"type":"string","description":"ID da inbox à qual o contato será vinculado."},"isBlocked":{"type":"boolean","description":"Define se o contato começa bloqueado."},"tags":{"type":"array","items":{"type":"string"},"description":"IDs de tags existentes na inbox. Omitir para criar sem tags."},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do campo personalizado do contato."},"value":{"type":"string","maxLength":2000,"description":"Valor como texto. Vazio apaga o valor do campo."}},"required":["id","value"],"additionalProperties":false},"maxItems":100,"description":"Valores de campos personalizados da inbox. Valor vazio é ignorado."}},"required":["name","phoneNumber","inboxId","isBlocked"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do contato criado."},"name":{"type":"string","description":"Nome do contato."},"email":{"type":"string","description":"E-mail do contato. Omitido se não informado."},"phoneNumber":{"type":"string","nullable":true,"description":"Número de telefone do contato."},"document":{"type":"string","description":"Documento do contato. Omitido se não informado."},"description":{"type":"string","description":"Anotações sobre o contato. Omitido se não informado."},"country":{"type":"string","description":"País. Omitido se não informado."},"city":{"type":"string","description":"Cidade. Omitida se não informada."},"isBlocked":{"type":"boolean","description":"Indica se o contato está bloqueado."},"inboxId":{"type":"string","description":"ID da inbox à qual o contato pertence."},"tags":{"type":"array","items":{"type":"string"},"description":"IDs das tags associadas ao contato."}},"required":["id","name","phoneNumber","isBlocked","inboxId"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir contatos","tags":["Contacts"],"description":"Remove um ou mais contatos pelos IDs informados.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs dos contatos a serem removidos."}},"required":["ids"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Confirmação da operação.","content":{"application/json":{"schema":{"type":"string","description":"Confirmação da operação."}}}}}}},"/people/{peopleId}":{"get":{"summary":"Obter contato","tags":["Contacts"],"description":"Retorna os dados de um contato pelo ID. O `inboxId` é obrigatório para garantir que o contato pertença à inbox informada.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox. Obrigatório para verificar que o contato pertence a essa caixa."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"peopleId","required":true,"description":"ID do contato."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do contato."},"name":{"type":"string","nullable":true,"description":"Nome do contato. Null se não informado."},"email":{"type":"string","nullable":true,"description":"E-mail. Null se não informado."},"imageUrl":{"type":"string","nullable":true,"description":"URL de avatar. Null se não definido."},"phoneNumber":{"type":"string","nullable":true,"description":"Número de telefone. Null se não informado."},"document":{"type":"string","nullable":true,"description":"CPF, CNPJ ou outro documento. Null se não informado."},"description":{"type":"string","nullable":true,"description":"Anotações sobre o contato. Null se não informado."},"country":{"type":"string","nullable":true,"description":"País. Null se não informado."},"city":{"type":"string","nullable":true,"description":"Cidade. Null se não informado."},"isBlocked":{"type":"boolean","description":"Indica se o contato está bloqueado."},"isPersonal":{"type":"boolean","description":"Contato pessoal: fora das métricas e sem IA, fluxo ou automação."},"inboxId":{"type":"string","description":"ID da inbox à qual o contato pertence."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."},"externalIdentitySource":{"type":"string","enum":["WEB_CHAT","INSTAGRAM"],"nullable":true,"description":"Origem externa do contato quando não veio de telefone."},"externalIdentityId":{"type":"string","nullable":true,"description":"Identificador externo do contato (ex.: sessão do web chat)."},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da tag."},"name":{"type":"string","description":"Nome da tag."},"color":{"type":"string","description":"Cor da tag (ex.: código hexadecimal)."}},"required":["id","name","color"],"additionalProperties":false},"description":"Tags associadas ao contato."},"crmColumns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da coluna do CRM."},"name":{"type":"string","description":"Nome da coluna do CRM."},"color":{"type":"string","description":"Cor da coluna do CRM."}},"required":["id","name","color"],"additionalProperties":false},"description":"Colunas do CRM associadas ao contato nesta inbox."},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do campo personalizado."},"name":{"type":"string","description":"Nome do campo."},"type":{"type":"string","description":"Tipo do campo."},"value":{"type":"string","description":"Valor preenchido."}},"required":["id","name","type","value"],"additionalProperties":false},"description":"Campos personalizados preenchidos no contato."}},"required":["id","name","email","imageUrl","phoneNumber","document","description","country","city","isBlocked","isPersonal","inboxId","createdAt","updatedAt","tags","crmColumns","customFields"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Atualizar contato","tags":["Contacts"],"description":"Atualização parcial: campos omitidos não são zerados. `tags`, quando presente, redefine todas as associações na inbox.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"inboxId":{"type":"string","description":"ID da inbox. Usado para localizar o contato corretamente."},"name":{"type":"string","description":"Novo nome do contato."},"imageUrl":{"type":"string","description":"Nova URL de avatar."},"phoneNumber":{"type":"string","description":"Novo número de telefone."},"document":{"type":"string","description":"Novo documento (CPF ou CNPJ, numérico ou alfanumérico)."},"description":{"type":"string","description":"Novas anotações sobre o contato."},"country":{"type":"string","description":"Novo país."},"city":{"type":"string","description":"Nova cidade."},"email":{"type":"string","description":"Novo e-mail."},"isBlocked":{"type":"boolean","description":"Altera o status de bloqueio do contato."},"isPersonal":{"type":"boolean","description":"Marca como contato pessoal: fora das métricas e sem IA, fluxo ou automação."},"tags":{"type":"array","items":{"type":"string"},"description":"Substitui todas as tags do contato pelos IDs enviados."},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do campo personalizado do contato."},"value":{"type":"string","maxLength":2000,"description":"Valor como texto. Vazio apaga o valor do campo."}},"required":["id","value"],"additionalProperties":false},"maxItems":100,"description":"Valores de campos personalizados. Só os enviados mudam; valor vazio apaga."}},"required":["inboxId"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"peopleId","required":true,"description":"ID do contato."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Confirmação da operação.","content":{"application/json":{"schema":{"type":"string","description":"Confirmação da operação."}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/people/import":{"post":{"summary":"Importar contatos em lote","tags":["Contacts"],"description":"Importa contatos para uma ou mais inboxes. Campos obrigatórios: name e phoneNumber. Com createConversation=true, também cria conversa na integração informada (integrationId). Retorna o que foi criado e o que falhou.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"inboxIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"minItems":1,"description":"Inboxes de destino do importe."},"contacts":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Nome do contato."},"phoneNumber":{"type":"string","minLength":1,"description":"Telefone do contato."},"email":{"type":"string","format":"email","description":"E-mail do contato."},"document":{"type":"string","description":"CPF ou CNPJ do contato."},"description":{"type":"string","description":"Anotações sobre o contato."},"country":{"type":"string","description":"País do contato."},"city":{"type":"string","description":"Cidade do contato."},"isBlocked":{"type":"boolean","description":"Define se o contato começa bloqueado. Padrão: false."},"tags":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs de tags existentes na inbox de destino."},"customFields":{"type":"object","additionalProperties":{"type":"string"},"description":"Valores por NOME do campo personalizado (sem diferenciar maiúsculas) em cada inbox de destino. Nome desconhecido é ignorado."}},"required":["name","phoneNumber"],"additionalProperties":false},"minItems":1,"maxItems":5000,"description":"Lista de contatos a importar."},"createConversation":{"type":"boolean","default":false,"description":"Quando true, cria uma conversa para cada contato novo na integração informada."},"integrationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"Canal de integração (WhatsApp, web chat etc.) onde a conversa será criada. Obrigatório quando createConversation é true."}},"required":["inboxIds","contacts"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"created":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","description":"Índice do contato na lista enviada."},"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do contato criado."},"name":{"type":"string","description":"Nome do contato criado."},"phoneNumber":{"type":"string","nullable":true,"description":"Telefone normalizado do contato."},"email":{"type":"string"},"document":{"type":"string"},"description":{"type":"string"},"country":{"type":"string"},"city":{"type":"string"},"isBlocked":{"type":"boolean"},"inboxId":{"type":"string","description":"Inbox onde o contato foi criado."},"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa criada ou reutilizada quando createConversation é true."}},"required":["index","id","name","phoneNumber","isBlocked","inboxId"],"additionalProperties":false}},"errors":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","description":"Índice do contato na lista enviada."},"inboxId":{"type":"string","description":"Inbox alvo quando aplicável."},"name":{"type":"string"},"phoneNumber":{"type":"string"},"reason":{"type":"string","description":"Motivo da falha ou duplicata."}},"required":["index","reason"],"additionalProperties":false}}},"required":["created","errors"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/people/personal":{"patch":{"summary":"Marcar contatos como pessoais","tags":["Contacts"],"description":"Marca ou desmarca contatos como pessoais. Contato pessoal fica fora das métricas e dos relatórios, e nem IA, nem fluxo, nem regra de automação falam com ele. Ids de outro escritório são ignorados.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"minItems":1,"maxItems":500,"description":"IDs dos contatos (até 500)."},"isPersonal":{"type":"boolean","description":"true marca como contato pessoal; false desmarca."}},"required":["ids","isPersonal"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Confirmação da operação.","content":{"application/json":{"schema":{"type":"string","description":"Confirmação da operação."}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/people-custom-field/":{"get":{"summary":"Listar campos personalizados de contato","tags":["Contacts"],"description":"Campos personalizados do contato definidos na inbox, em ordem de criação.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do campo personalizado."},"name":{"type":"string","description":"Nome do campo."},"type":{"type":"string","description":"Tipo do campo."},"options":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Opções de `select`/`multiselect`; null nos demais tipos."},"inboxId":{"type":"string","description":"Inbox dona do campo."},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","type","options","inboxId","createdAt","updatedAt"],"additionalProperties":false}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Criar campo personalizado de contato","tags":["Contacts"],"description":"Cria um campo do contato na inbox. Até 100 campos por inbox; nome repetido retorna 409.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"inboxId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da inbox dona do campo."},"name":{"type":"string","minLength":1,"maxLength":60,"description":"Nome do campo. Único na inbox, sem diferenciar maiúsculas."},"type":{"type":"string","enum":["text","longtext","date","time","datetime","number","select","multiselect"],"description":"Tipo do campo. Não muda depois de criado."},"options":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"maxItems":50,"description":"Opções, obrigatórias em `select` e `multiselect`."}},"required":["inboxId","name","type"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do campo personalizado."},"name":{"type":"string","description":"Nome do campo."},"type":{"type":"string","description":"Tipo do campo."},"options":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Opções de `select`/`multiselect`; null nos demais tipos."},"inboxId":{"type":"string","description":"Inbox dona do campo."},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","type","options","inboxId","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/people-custom-field/{id}":{"patch":{"summary":"Editar campo personalizado de contato","tags":["Contacts"],"description":"Altera nome e opções. O tipo não muda (400). Remover uma opção mantém o valor já gravado nos contatos.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60,"description":"Nome do campo. Único na inbox, sem diferenciar maiúsculas."},"type":{"type":"string","enum":["text","longtext","date","time","datetime","number","select","multiselect"],"description":"Aceito só se igual ao atual: o tipo não muda depois de criado."},"options":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"maxItems":50,"description":"Opções, obrigatórias em `select` e `multiselect`."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do campo personalizado."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do campo personalizado."},"name":{"type":"string","description":"Nome do campo."},"type":{"type":"string","description":"Tipo do campo."},"options":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Opções de `select`/`multiselect`; null nos demais tipos."},"inboxId":{"type":"string","description":"Inbox dona do campo."},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","type","options","inboxId","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir campo personalizado de contato","tags":["Contacts"],"description":"Remove o campo e o valor dele em todos os contatos da inbox.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do campo personalizado."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Retorna `ok` em caso de sucesso.","content":{"application/json":{"schema":{"type":"string","description":"Retorna `ok` em caso de sucesso."}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/agents/":{"get":{"summary":"Listar agentes","tags":["Agents"],"description":"Lista agentes com filtros e paginação","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox."},{"schema":{"type":"string"},"in":"query","name":"name","required":false,"description":"Filtra agentes pelo nome."},{"schema":{"type":"string"},"in":"query","name":"communicationStyle","required":false,"description":"Filtra pelo estilo de comunicação."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"integrationId","required":false,"description":"Filtra agentes vinculados a uma integração."},{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"page","required":false,"description":"Número da página."},{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"limit","required":false,"description":"Quantidade de itens por página."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"avatarUrl":{"type":"string","nullable":true},"communicationStyle":{"type":"string"},"behavior":{"type":"string"},"purpose":{"type":"string"},"agentModelId":{"type":"string"},"productName":{"type":"string","nullable":true},"productSite":{"type":"string","nullable":true},"productDescription":{"type":"string","nullable":true},"inboxId":{"type":"string"},"hasConversationsActive":{"type":"boolean"},"hasIntegrationActive":{"type":"boolean"},"activation":{"type":"object","properties":{"status":{"type":"string","enum":["ACTIVE","PARTIAL","INACTIVE"]},"keywords":{"type":"array","items":{"type":"string"}},"flows":{"type":"array","items":{"type":"string"}}},"required":["status","keywords","flows"],"additionalProperties":false,"description":"Onde o agente responde. PARTIAL: só com as palavras de ativação (WhatsApp) ou nas conversas que os fluxos listados entregam a ele."},"activePeriodEnabled":{"type":"boolean"},"activePeriodPreset":{"type":"string","nullable":true},"allowConsultingProcesses":{"type":"boolean"},"canCreateTickets":{"type":"boolean"},"configSource":{"type":"string","enum":["ATHENA","LEGACY"],"description":"ATHENA: configurado pela Athena. LEGACY: configuração antiga."},"objective":{"type":"string","enum":["SALES","POST_SALES"],"nullable":true,"description":"Objetivo da versão da Athena no ar."},"draftOnboardingId":{"type":"string","nullable":true,"description":"Rascunho de reconfiguração com a Athena em andamento."},"liveOnboardingId":{"type":"string","nullable":true,"description":"Versão da Athena no ar: suas respostas são as editáveis na tela do agente."},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"idleActions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"timeoutMinutes":{"type":"number","nullable":true},"maxAttempts":{"type":"number"},"action":{"type":"string"},"customMessage":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number","nullable":true},"followUpTopics":{"type":"array","items":{"type":"string"}},"skipFollowUpTopics":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","timeoutMinutes","maxAttempts","action","customMessage","enabled","priority","followUpTopics","skipFollowUpTopics","createdAt","updatedAt"],"additionalProperties":false}},"transferRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"transferMessage":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","responseTimeMinutes","customCondition","transferMessage","enabled","priority","createdAt","updatedAt"],"additionalProperties":false}},"ticketRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number"},"ticketTitle":{"type":"string"},"ticketDescription":{"type":"string","nullable":true},"ticketPriority":{"type":"string"},"statusId":{"type":"string","nullable":true},"assigneeIds":{"type":"array","items":{"type":"string"}},"departmentIds":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","responseTimeMinutes","customCondition","enabled","priority","ticketTitle","ticketDescription","ticketPriority","statusId","assigneeIds","departmentIds","createdAt","updatedAt"],"additionalProperties":false}},"tagRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"tagIds":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","customCondition","tagIds","enabled","priority","createdAt","updatedAt"],"additionalProperties":false}},"crmRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"funnelColumnId":{"type":"string"},"enabled":{"type":"boolean"},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","customCondition","funnelColumnId","enabled","priority","createdAt","updatedAt"],"additionalProperties":false}},"customSchedule":{"type":"array","items":{"type":"object","properties":{"dayOfWeek":{"type":"string"},"enabled":{"type":"boolean"},"startTime":{"type":"string"},"endTime":{"type":"string"}},"required":["dayOfWeek","enabled","startTime","endTime"],"additionalProperties":false},"nullable":true}},"required":["id","name","avatarUrl","communicationStyle","behavior","purpose","agentModelId","productName","productSite","productDescription","inboxId","hasConversationsActive","hasIntegrationActive","activation","activePeriodEnabled","activePeriodPreset","allowConsultingProcesses","configSource","objective","draftOnboardingId","liveOnboardingId","createdAt","updatedAt","idleActions","transferRules","ticketRules","tagRules","crmRules","customSchedule"],"additionalProperties":false}},"totalResults":{"type":"number"},"totalPages":{"type":"number"}},"required":["data","totalResults","totalPages"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Criar agente","tags":["Agents"],"description":"Cria um novo agente no sistema","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome do agente."},"avatarUrl":{"type":"string","description":"URL do avatar do agente."},"communicationStyle":{"type":"string","description":"Estilo de comunicação do agente."},"behavior":{"type":"string","description":"Comportamento esperado do agente."},"purpose":{"type":"string","description":"Objetivo do agente."},"agentModelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do modelo de LLM."},"productName":{"type":"string","description":"Nome do produto ou escritório."},"productSite":{"type":"string","description":"Site do produto ou escritório."},"productDescription":{"type":"string","description":"Descrição do produto ou escritório."},"canRequestHumanHelp":{"type":"boolean","default":false,"description":"Permite solicitar atendimento humano."},"canCreateTickets":{"type":"boolean","default":false,"description":"Permite criar tickets automaticamente."},"restrictToAllowedTopics":{"type":"boolean","default":false,"description":"Restringe o agente aos tópicos permitidos."},"allowConsultingProcesses":{"type":"boolean","default":false,"description":"Permite consultar processos."},"activationKeywords":{"type":"array","items":{"type":"string","maxLength":100,"pattern":"[\\p{L}\\p{N}]"},"maxItems":30,"description":"Palavras de ativação (só WhatsApp). Com a lista preenchida, o agente só começa o atendimento cuja mensagem de abertura contém uma delas, por palavra ou frase inteira, sem diferenciar acento e maiúscula; em mídia vale a legenda. Abre o atendimento a mensagem do contato em conversa nova, encerrada ou que ninguém atendeu. Conversa já com o agente segue. Vazia: sem trava. Até 30, de até 100 caracteres, cada uma com ao menos uma letra ou número. A lista volta aparada e sem repetidas pela mesma comparação (fica a 1ª grafia: [\"Divórcio\", \"divorcio\"] vira [\"Divórcio\"]). No PATCH, sem o campo nada muda e [] limpa."},"canScheduleMeetings":{"type":"boolean","default":false,"description":"Permite que o agente marque reuniões na agenda escolhida."},"calendarId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","nullable":true,"description":"Agenda onde o agente marca reuniões. Nula = agenda do agente do escritório ou conexão antiga do Google."},"schedulingScheduleEnabled":{"type":"boolean","default":false,"description":"Restringe o agendamento aos dias e horários configurados."},"schedulingSchedule":{"type":"object","properties":{"monday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"tuesday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"wednesday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"thursday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"friday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"saturday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"sunday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false}},"additionalProperties":false,"description":"Dias e horários disponíveis para agendamento."},"schedulingSlotDurationMinutes":{"type":"integer","exclusiveMinimum":0,"maximum":240,"default":30,"description":"Duração padrão da reunião, em minutos."},"schedulingAllowOverlap":{"type":"boolean","default":false,"description":"Permite mais de uma reunião no mesmo horário."},"schedulingMaxPerSlot":{"type":"integer","minimum":1,"maximum":50,"default":1,"description":"Teto de reuniões simultâneas quando a sobreposição está ativa."},"schedulingMinAdvanceMinutes":{"type":"integer","minimum":0,"default":60,"description":"Antecedência mínima, em minutos, para marcar."},"schedulingMaxAdvanceDays":{"type":"integer","minimum":1,"maximum":365,"default":60,"description":"Quantos dias à frente o agente pode marcar."},"canSendContracts":{"type":"boolean","default":false,"description":"Permite que o agente envie os contratos de `contractRules` para assinatura."},"responseDelaySeconds":{"type":"number","nullable":true,"description":"Atraso em segundos antes de responder. Null para imediato."},"maxInteractionsPerSession":{"type":"number","nullable":true,"description":"Limite de interações por sessão. Null para ilimitado."},"endTriggerResolvedIntentEnabled":{"type":"boolean","default":false,"description":"Encerra a conversa quando a IA avalia que a dúvida do cliente foi respondida."},"endTriggerUserRequestEnabled":{"type":"boolean","default":false,"description":"Encerra a conversa quando o cliente pede explicitamente para encerrar."},"endTriggerInactivityEnabled":{"type":"boolean","default":false,"description":"Encerra a conversa após um tempo de silêncio do cliente."},"endTriggerInactivityMinutes":{"type":"integer","minimum":1,"maximum":10080,"nullable":true,"description":"Minutos de silêncio antes do encerramento por inatividade. Null usa 30."},"endTriggerAction":{"type":"string","enum":["END_WITHOUT_MESSAGE","END_WITH_FAREWELL"],"default":"END_WITHOUT_MESSAGE","description":"Ação aplicada a qualquer gatilho de encerramento que disparar."},"endTriggerFarewellMessage":{"type":"string","maxLength":512,"nullable":true,"description":"Mensagem de despedida. Usada só com END_WITH_FAREWELL."},"inboxId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da inbox."},"activePeriodEnabled":{"type":"boolean","default":false,"description":"Ativa o horário de funcionamento do agente."},"activePeriodPreset":{"type":"string","enum":["CUSTOM","BUSINESS_HOURS","EXTENDED_HOURS","WEEKENDS_ONLY","TWENTY_FOUR_SEVEN"],"description":"Preset de horário de funcionamento."},"idleActions":{"type":"array","items":{"type":"object","properties":{"timeoutMinutes":{"type":"number","maximum":5760,"nullable":true},"maxAttempts":{"type":"integer","minimum":1,"maximum":20,"default":1},"action":{"type":"string","enum":["ENGAGE_CUSTOMER","END_SERVICE","TRANSFER_TO_HUMAN"]},"customMessage":{"type":"string","nullable":true},"enabled":{"type":"boolean","default":true},"priority":{"type":"number","nullable":true},"followUpTopics":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"maxItems":20},"skipFollowUpTopics":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"maxItems":20}},"required":["action"],"additionalProperties":false}},"transferRules":{"type":"array","items":{"type":"object","properties":{"condition":{"type":"string","enum":["KEYWORDS","SENTIMENT","INTERACTION_COUNT","RESPONSE_TIME","CUSTOM"]},"keywords":{"type":"array","items":{"type":"string"},"default":[]},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"transferMessage":{"type":"string","nullable":true},"enabled":{"type":"boolean","default":true},"priority":{"type":"number","nullable":true,"default":0},"userId":{"type":"string","nullable":true},"roleId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"distributeByChannel":{"type":"boolean"}},"required":["condition"],"additionalProperties":false}},"schedulingRules":{"type":"array","items":{"type":"object","properties":{"condition":{"type":"string","enum":["KEYWORDS","INTERACTION_COUNT","CUSTOM"]},"keywords":{"type":"array","items":{"type":"string"},"default":[]},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"integer","exclusiveMinimum":0,"nullable":true},"responseTimeMinutes":{"type":"integer","exclusiveMinimum":0,"nullable":true},"customCondition":{"type":"string","maxLength":512,"nullable":true},"enabled":{"type":"boolean","default":true},"priority":{"type":"integer","nullable":true,"default":0},"meetingTitle":{"type":"string","minLength":1,"maxLength":255},"meetingDescription":{"type":"string","maxLength":5000,"nullable":true},"durationMinutes":{"type":"integer","exclusiveMinimum":0,"maximum":240,"default":30}},"required":["condition","meetingTitle"],"additionalProperties":false},"description":"Regras que liberam o agendamento automático na conversa."},"contractRules":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"criteria":{"type":"string","minLength":1,"maxLength":2000},"provider":{"type":"string","enum":["JURIDIQ","ZAPSIGN"]},"templateId":{"type":"string","minLength":1},"templateName":{"type":"string","maxLength":255,"nullable":true},"extraTemplates":{"type":"array","items":{"type":"object","properties":{"templateId":{"type":"string","minLength":1},"templateName":{"type":"string","maxLength":255,"nullable":true}},"required":["templateId"],"additionalProperties":false},"maxItems":5,"default":[]},"fields":{"type":"object","additionalProperties":{"anyOf":[{"type":"object","properties":{"client":{"type":"string","enum":["name","document","rg","birthDate","maritalStatus","profession","nationality","email","phone","zipCode","streetAndNumber","neighborhood","city","state","address"]}},"required":["client"],"additionalProperties":false},{"type":"object","properties":{"person2":{"type":"string","enum":["name","document","rg","birthDate","maritalStatus","profession","nationality","email","phone","zipCode","streetAndNumber","neighborhood","city","state","address"]}},"required":["person2"],"additionalProperties":false},{"type":"object","properties":{"custom":{"type":"string","minLength":1,"maxLength":64}},"required":["custom"],"additionalProperties":false},{"type":"object","properties":{"fixed":{"type":"string","maxLength":5000}},"required":["fixed"],"additionalProperties":false}]},"default":{}},"requireSelfie":{"type":"boolean","default":false},"requireDocument":{"type":"boolean","default":false},"expiresInDays":{"type":"integer","minimum":1,"maximum":365,"nullable":true},"enabled":{"type":"boolean","default":true},"priority":{"type":"integer","nullable":true,"default":0}},"required":["name","criteria","provider","templateId"],"additionalProperties":false},"description":"Contratos que o agente pode enviar para assinatura."},"ticketRules":{"type":"array","items":{"type":"object","properties":{"condition":{"type":"string","enum":["KEYWORDS","SENTIMENT","INTERACTION_COUNT","RESPONSE_TIME","CUSTOM"]},"keywords":{"type":"array","items":{"type":"string"},"default":[]},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"enabled":{"type":"boolean","default":true},"priority":{"type":"number","nullable":true,"default":0},"ticketTitle":{"type":"string","minLength":1},"ticketDescription":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"default":"LOW"},"statusId":{"type":"string","nullable":true},"assigneeIds":{"type":"array","items":{"type":"string"},"default":[]},"departmentIds":{"type":"array","items":{"type":"string"},"default":[]}},"required":["condition","ticketTitle"],"additionalProperties":false}},"tagRules":{"type":"array","items":{"type":"object","properties":{"condition":{"type":"string","enum":["KEYWORDS","SENTIMENT","INTERACTION_COUNT","CUSTOM","MEETING_SCHEDULED","CONTRACT_SENT","CONTRACT_SIGNED"]},"keywords":{"type":"array","items":{"type":"string"},"default":[]},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"default":[]},"enabled":{"type":"boolean","default":true},"priority":{"type":"number","nullable":true,"default":0}},"required":["condition"],"additionalProperties":false}},"crmRules":{"type":"array","items":{"type":"object","properties":{"condition":{"type":"string","enum":["KEYWORDS","SENTIMENT","INTERACTION_COUNT","CUSTOM","MEETING_SCHEDULED","CONTRACT_SENT","CONTRACT_SIGNED"]},"keywords":{"type":"array","items":{"type":"string"},"default":[]},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"enabled":{"type":"boolean","default":true},"priority":{"type":"number","nullable":true,"default":0}},"required":["condition","funnelColumnId"],"additionalProperties":false}},"customSchedule":{"type":"array","items":{"type":"object","properties":{"dayOfWeek":{"type":"string","enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"]},"enabled":{"type":"boolean","default":false},"startTime":{"type":"string","pattern":"^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$"},"endTime":{"type":"string","pattern":"^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$"}},"required":["dayOfWeek","startTime","endTime"],"additionalProperties":false}}},"required":["name","communicationStyle","behavior","purpose","agentModelId","inboxId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string"},"avatarUrl":{"type":"string","nullable":true},"communicationStyle":{"type":"string"},"behavior":{"type":"string"},"purpose":{"type":"string"},"agentModelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"productName":{"type":"string","nullable":true},"productSite":{"type":"string","nullable":true},"productDescription":{"type":"string","nullable":true},"canRequestHumanHelp":{"type":"boolean"},"canCreateTickets":{"type":"boolean"},"restrictToAllowedTopics":{"type":"boolean"},"activationKeywords":{"type":"array","items":{"type":"string"}},"responseDelaySeconds":{"type":"number","nullable":true},"maxInteractionsPerSession":{"type":"number","nullable":true},"endTriggerResolvedIntentEnabled":{"type":"boolean"},"endTriggerUserRequestEnabled":{"type":"boolean"},"endTriggerInactivityEnabled":{"type":"boolean"},"endTriggerInactivityMinutes":{"type":"number","nullable":true},"endTriggerAction":{"type":"string"},"endTriggerFarewellMessage":{"type":"string","nullable":true},"inboxId":{"type":"string"},"activePeriodEnabled":{"type":"boolean"},"activePeriodPreset":{"type":"string","nullable":true},"allowConsultingProcesses":{"type":"boolean"},"canScheduleMeetings":{"type":"boolean"},"calendarId":{"type":"string","nullable":true},"schedulingScheduleEnabled":{"type":"boolean"},"schedulingSchedule":{"nullable":true},"schedulingSlotDurationMinutes":{"type":"number"},"schedulingAllowOverlap":{"type":"boolean"},"schedulingMaxPerSlot":{"type":"number"},"schedulingMinAdvanceMinutes":{"type":"number"},"schedulingMaxAdvanceDays":{"type":"number"},"schedulingRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number"},"meetingTitle":{"type":"string"},"meetingDescription":{"type":"string","nullable":true},"durationMinutes":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","responseTimeMinutes","customCondition","enabled","priority","meetingTitle","meetingDescription","durationMinutes","createdAt","updatedAt"],"additionalProperties":false}},"canSendContracts":{"type":"boolean"},"contractRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"criteria":{"type":"string"},"provider":{"type":"string"},"templateId":{"type":"string"},"templateName":{"type":"string","nullable":true},"extraTemplates":{},"fields":{},"requireSelfie":{"type":"boolean"},"requireDocument":{"type":"boolean"},"expiresInDays":{"type":"number","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","criteria","provider","templateId","templateName","requireSelfie","requireDocument","expiresInDays","enabled","priority","createdAt","updatedAt"],"additionalProperties":false}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"idleActions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"timeoutMinutes":{"type":"number","nullable":true},"maxAttempts":{"type":"number"},"action":{"type":"string"},"customMessage":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number","nullable":true},"followUpTopics":{"type":"array","items":{"type":"string"}},"skipFollowUpTopics":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","timeoutMinutes","maxAttempts","action","customMessage","enabled","priority","followUpTopics","skipFollowUpTopics","createdAt","updatedAt"],"additionalProperties":false}},"transferRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"transferMessage":{"type":"string","nullable":true},"userId":{"type":"string","nullable":true},"roleId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"distributeByChannel":{"type":"boolean"},"enabled":{"type":"boolean"},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","responseTimeMinutes","customCondition","transferMessage","userId","roleId","departmentId","distributeByChannel","enabled","priority","createdAt","updatedAt"],"additionalProperties":false}},"ticketRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number"},"ticketTitle":{"type":"string"},"ticketDescription":{"type":"string","nullable":true},"ticketPriority":{"type":"string"},"statusId":{"type":"string","nullable":true},"assigneeIds":{"type":"array","items":{"type":"string"}},"departmentIds":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","responseTimeMinutes","customCondition","enabled","priority","ticketTitle","ticketDescription","ticketPriority","statusId","assigneeIds","departmentIds","createdAt","updatedAt"],"additionalProperties":false}},"tagRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"tagIds":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","customCondition","tagIds","enabled","priority","createdAt","updatedAt"],"additionalProperties":false}},"crmRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"funnelColumnId":{"type":"string"},"enabled":{"type":"boolean"},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","customCondition","funnelColumnId","enabled","priority","createdAt","updatedAt"],"additionalProperties":false}},"customSchedule":{"type":"array","items":{"type":"object","properties":{"dayOfWeek":{"type":"string"},"enabled":{"type":"boolean"},"startTime":{"type":"string"},"endTime":{"type":"string"}},"required":["dayOfWeek","enabled","startTime","endTime"],"additionalProperties":false},"nullable":true}},"required":["id","name","avatarUrl","communicationStyle","behavior","purpose","agentModelId","productName","productSite","productDescription","canRequestHumanHelp","canCreateTickets","restrictToAllowedTopics","activationKeywords","responseDelaySeconds","maxInteractionsPerSession","endTriggerResolvedIntentEnabled","endTriggerUserRequestEnabled","endTriggerInactivityEnabled","endTriggerInactivityMinutes","endTriggerAction","endTriggerFarewellMessage","inboxId","activePeriodEnabled","activePeriodPreset","allowConsultingProcesses","canScheduleMeetings","calendarId","schedulingScheduleEnabled","schedulingSlotDurationMinutes","schedulingAllowOverlap","schedulingMaxPerSlot","schedulingMinAdvanceMinutes","schedulingMaxAdvanceDays","schedulingRules","canSendContracts","contractRules","createdAt","updatedAt","idleActions","transferRules","ticketRules","tagRules","crmRules","customSchedule"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/agents/{id}/links":{"get":{"summary":"Buscar vínculos do agente","tags":["Agents"],"description":"Retorna os vínculos ativos do agente em integração e conversas","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do agente."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"integration":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"nullable":true},"conversations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"personDisplayName":{"type":"string"}},"required":["id","personDisplayName"],"additionalProperties":false}}},"required":["integration","conversations"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/agents/{id}":{"get":{"summary":"Buscar agente","tags":["Agents"],"description":"Busca um agente específico por ID","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do agente."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string"},"avatarUrl":{"type":"string","nullable":true},"communicationStyle":{"type":"string"},"behavior":{"type":"string"},"purpose":{"type":"string"},"productName":{"type":"string","nullable":true},"productSite":{"type":"string","nullable":true},"productDescription":{"type":"string","nullable":true},"agentModelId":{"type":"string"},"inboxId":{"type":"string"},"hasConversationsActive":{"type":"boolean"},"hasIntegrationActive":{"type":"boolean"},"activation":{"type":"object","properties":{"status":{"type":"string","enum":["ACTIVE","PARTIAL","INACTIVE"]},"keywords":{"type":"array","items":{"type":"string"}},"flows":{"type":"array","items":{"type":"string"}}},"required":["status","keywords","flows"],"additionalProperties":false,"description":"Onde o agente responde. PARTIAL: só com as palavras de ativação (WhatsApp) ou nas conversas que os fluxos listados entregam a ele."},"activePeriodEnabled":{"type":"boolean"},"activePeriodPreset":{"type":"string","nullable":true},"maxInteractionsPerSession":{"type":"number","nullable":true},"endTriggerResolvedIntentEnabled":{"type":"boolean"},"endTriggerUserRequestEnabled":{"type":"boolean"},"endTriggerInactivityEnabled":{"type":"boolean"},"endTriggerInactivityMinutes":{"type":"number","nullable":true},"endTriggerAction":{"type":"string"},"endTriggerFarewellMessage":{"type":"string","nullable":true},"allowConsultingProcesses":{"type":"boolean"},"canRequestHumanHelp":{"type":"boolean"},"canCreateTickets":{"type":"boolean"},"configSource":{"type":"string","enum":["ATHENA","LEGACY"],"description":"ATHENA: configurado pela Athena. LEGACY: configuração antiga."},"objective":{"type":"string","enum":["SALES","POST_SALES"],"nullable":true,"description":"Objetivo da versão da Athena no ar."},"draftOnboardingId":{"type":"string","nullable":true,"description":"Rascunho de reconfiguração com a Athena em andamento."},"liveOnboardingId":{"type":"string","nullable":true,"description":"Versão da Athena no ar: suas respostas são as editáveis na tela do agente."},"personaName":{"type":"string","nullable":true,"description":"Nome que o agente usa com o cliente, da versão da Athena no ar."},"canScheduleMeetings":{"type":"boolean"},"calendarId":{"type":"string","nullable":true},"schedulingScheduleEnabled":{"type":"boolean"},"schedulingSchedule":{"nullable":true},"schedulingSlotDurationMinutes":{"type":"number"},"schedulingAllowOverlap":{"type":"boolean"},"schedulingMaxPerSlot":{"type":"number"},"schedulingMinAdvanceMinutes":{"type":"number"},"schedulingMaxAdvanceDays":{"type":"number"},"calendar":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"provider":{"type":"string","enum":["internal","google"]},"ownerName":{"type":"string","nullable":true}},"required":["id","name","provider","ownerName"],"additionalProperties":false,"nullable":true,"description":"Agenda do agente (`calendarId`)."},"hasLegacyGoogleConnection":{"type":"boolean","description":"O escritório tem a conexão antiga do Google (módulo `google-calendar`)."},"schedulingTimezone":{"type":"string","description":"Fuso do escritório em que a janela de agendamento vale."},"schedulingRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number"},"meetingTitle":{"type":"string"},"meetingDescription":{"type":"string","nullable":true},"durationMinutes":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","responseTimeMinutes","customCondition","enabled","priority","meetingTitle","meetingDescription","durationMinutes","createdAt","updatedAt"],"additionalProperties":false}},"canSendContracts":{"type":"boolean"},"contractRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"criteria":{"type":"string"},"provider":{"type":"string"},"templateId":{"type":"string"},"templateName":{"type":"string","nullable":true},"extraTemplates":{},"fields":{},"requireSelfie":{"type":"boolean"},"requireDocument":{"type":"boolean"},"expiresInDays":{"type":"number","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","criteria","provider","templateId","templateName","requireSelfie","requireDocument","expiresInDays","enabled","priority","createdAt","updatedAt"],"additionalProperties":false}},"restrictToAllowedTopics":{"type":"boolean"},"activationKeywords":{"type":"array","items":{"type":"string"}},"responseDelaySeconds":{"type":"number","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"inbox":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"agentTrainings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"question":{"type":"string"},"answer":{"type":"string"},"isActive":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","question","answer","isActive","createdAt","updatedAt"],"additionalProperties":false}},"customSchedule":{"type":"array","items":{"type":"object","properties":{"dayOfWeek":{"type":"string"},"enabled":{"type":"boolean"},"startTime":{"type":"string"},"endTime":{"type":"string"}},"required":["dayOfWeek","enabled","startTime","endTime"],"additionalProperties":false},"nullable":true},"idleActions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"timeoutMinutes":{"type":"number","nullable":true},"maxAttempts":{"type":"number"},"action":{"type":"string"},"customMessage":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number","nullable":true},"followUpTopics":{"type":"array","items":{"type":"string"}},"skipFollowUpTopics":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","timeoutMinutes","maxAttempts","action","customMessage","enabled","priority","followUpTopics","skipFollowUpTopics","createdAt","updatedAt"],"additionalProperties":false}},"transferRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"transferMessage":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number"},"userId":{"type":"string","nullable":true},"roleId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"distributeByChannel":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","responseTimeMinutes","customCondition","transferMessage","enabled","priority","userId","roleId","departmentId","distributeByChannel","createdAt","updatedAt"],"additionalProperties":false}},"ticketRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number"},"ticketTitle":{"type":"string"},"ticketDescription":{"type":"string","nullable":true},"ticketPriority":{"type":"string"},"statusId":{"type":"string","nullable":true},"assigneeIds":{"type":"array","items":{"type":"string"}},"departmentIds":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","responseTimeMinutes","customCondition","enabled","priority","ticketTitle","ticketDescription","ticketPriority","statusId","assigneeIds","departmentIds","createdAt","updatedAt"],"additionalProperties":false}},"tagRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"tagIds":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","customCondition","tagIds","enabled","priority","createdAt","updatedAt"],"additionalProperties":false}},"crmRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"funnelColumnId":{"type":"string"},"enabled":{"type":"boolean"},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","customCondition","funnelColumnId","enabled","priority","createdAt","updatedAt"],"additionalProperties":false}}},"required":["id","name","avatarUrl","communicationStyle","behavior","purpose","productName","productSite","productDescription","agentModelId","inboxId","hasConversationsActive","hasIntegrationActive","activation","activePeriodEnabled","activePeriodPreset","maxInteractionsPerSession","endTriggerResolvedIntentEnabled","endTriggerUserRequestEnabled","endTriggerInactivityEnabled","endTriggerInactivityMinutes","endTriggerAction","endTriggerFarewellMessage","allowConsultingProcesses","canRequestHumanHelp","canCreateTickets","configSource","objective","draftOnboardingId","liveOnboardingId","personaName","canScheduleMeetings","calendarId","schedulingScheduleEnabled","schedulingSlotDurationMinutes","schedulingAllowOverlap","schedulingMaxPerSlot","schedulingMinAdvanceMinutes","schedulingMaxAdvanceDays","calendar","hasLegacyGoogleConnection","schedulingTimezone","schedulingRules","canSendContracts","contractRules","restrictToAllowedTopics","activationKeywords","responseDelaySeconds","createdAt","updatedAt","inbox","agentTrainings","customSchedule","idleActions","transferRules","ticketRules","tagRules","crmRules"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Deletar agente","tags":["Agents"],"description":"Remove um agente do sistema","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do agente."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Atualizar agente","tags":["Agents"],"description":"Atualiza um agente existente","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","nullable":true,"description":"Nome do agente."},"avatarUrl":{"type":"string","description":"URL do avatar do agente."},"communicationStyle":{"type":"string","nullable":true,"description":"Estilo de comunicação do agente."},"behavior":{"type":"string","nullable":true,"description":"Comportamento esperado do agente."},"purpose":{"type":"string","nullable":true,"description":"Objetivo do agente."},"agentModelId":{"type":"string","nullable":true,"description":"ID do modelo de LLM."},"productName":{"type":"string","description":"Nome do produto ou escritório."},"productSite":{"type":"string","description":"Site do produto ou escritório."},"productDescription":{"type":"string","description":"Descrição do produto ou escritório."},"canRequestHumanHelp":{"type":"boolean","description":"Permite solicitar atendimento humano."},"canCreateTickets":{"type":"boolean","description":"Permite criar tickets automaticamente."},"canScheduleMeetings":{"type":"boolean"},"calendarId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","nullable":true},"schedulingScheduleEnabled":{"type":"boolean"},"schedulingSchedule":{"type":"object","properties":{"monday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"tuesday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"wednesday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"thursday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"friday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"saturday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false},"sunday":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["intervals"],"additionalProperties":false}},"additionalProperties":false},"schedulingSlotDurationMinutes":{"type":"integer","exclusiveMinimum":0,"maximum":240},"schedulingAllowOverlap":{"type":"boolean"},"schedulingMaxPerSlot":{"type":"integer","minimum":1,"maximum":50},"schedulingMinAdvanceMinutes":{"type":"integer","minimum":0},"schedulingMaxAdvanceDays":{"type":"integer","minimum":1,"maximum":365},"canSendContracts":{"type":"boolean"},"restrictToAllowedTopics":{"type":"boolean","description":"Restringe o agente aos tópicos permitidos."},"activationKeywords":{"type":"array","items":{"type":"string","maxLength":100,"pattern":"[\\p{L}\\p{N}]"},"maxItems":30,"description":"Palavras de ativação (só WhatsApp). Com a lista preenchida, o agente só começa o atendimento cuja mensagem de abertura contém uma delas, por palavra ou frase inteira, sem diferenciar acento e maiúscula; em mídia vale a legenda. Abre o atendimento a mensagem do contato em conversa nova, encerrada ou que ninguém atendeu. Conversa já com o agente segue. Vazia: sem trava. Até 30, de até 100 caracteres, cada uma com ao menos uma letra ou número. A lista volta aparada e sem repetidas pela mesma comparação (fica a 1ª grafia: [\"Divórcio\", \"divorcio\"] vira [\"Divórcio\"]). No PATCH, sem o campo nada muda e [] limpa."},"responseDelaySeconds":{"type":"number","nullable":true,"description":"Atraso em segundos antes de responder. Null para imediato."},"maxInteractionsPerSession":{"type":"number","nullable":true,"description":"Limite de interações por sessão. Null para ilimitado."},"endTriggerResolvedIntentEnabled":{"type":"boolean","description":"Encerra a conversa quando a IA avalia que a dúvida do cliente foi respondida."},"endTriggerUserRequestEnabled":{"type":"boolean","description":"Encerra a conversa quando o cliente pede explicitamente para encerrar."},"endTriggerInactivityEnabled":{"type":"boolean","description":"Encerra a conversa após um tempo de silêncio do cliente."},"endTriggerInactivityMinutes":{"type":"integer","minimum":1,"maximum":10080,"nullable":true,"description":"Minutos de silêncio antes do encerramento por inatividade. Null usa 30."},"endTriggerAction":{"type":"string","enum":["END_WITHOUT_MESSAGE","END_WITH_FAREWELL"],"description":"Ação aplicada a qualquer gatilho de encerramento que disparar."},"endTriggerFarewellMessage":{"type":"string","maxLength":512,"nullable":true,"description":"Mensagem de despedida. Usada só com END_WITH_FAREWELL."},"allowConsultingProcesses":{"type":"boolean","description":"Permite consultar processos."},"activePeriodEnabled":{"type":"boolean","description":"Ativa o horário de funcionamento do agente."},"activePeriodPreset":{"type":"string","enum":["CUSTOM","BUSINESS_HOURS","EXTENDED_HOURS","WEEKENDS_ONLY","TWENTY_FOUR_SEVEN"],"description":"Preset de horário de funcionamento."},"idleActions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"timeoutMinutes":{"type":"number","maximum":5760,"nullable":true},"maxAttempts":{"type":"integer","minimum":1,"maximum":20,"default":1},"action":{"type":"string","enum":["ENGAGE_CUSTOMER","END_SERVICE","TRANSFER_TO_HUMAN"]},"customMessage":{"type":"string","nullable":true},"enabled":{"type":"boolean","default":true},"priority":{"type":"number","nullable":true,"default":0},"followUpTopics":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"maxItems":20},"skipFollowUpTopics":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"maxItems":20}},"required":["action"],"additionalProperties":false}},"transferRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"condition":{"type":"string","enum":["KEYWORDS","SENTIMENT","INTERACTION_COUNT","RESPONSE_TIME","CUSTOM"]},"keywords":{"type":"array","items":{"type":"string"},"default":[]},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"transferMessage":{"type":"string","nullable":true},"enabled":{"type":"boolean","default":true},"priority":{"type":"number","nullable":true,"default":0},"userId":{"type":"string","nullable":true},"roleId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"distributeByChannel":{"type":"boolean"}},"required":["condition"],"additionalProperties":false}},"schedulingRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"condition":{"type":"string","enum":["KEYWORDS","INTERACTION_COUNT","CUSTOM"]},"keywords":{"type":"array","items":{"type":"string"},"default":[]},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"integer","exclusiveMinimum":0,"nullable":true},"responseTimeMinutes":{"type":"integer","exclusiveMinimum":0,"nullable":true},"customCondition":{"type":"string","maxLength":512,"nullable":true},"enabled":{"type":"boolean","default":true},"priority":{"type":"integer","nullable":true,"default":0},"meetingTitle":{"type":"string","minLength":1,"maxLength":255},"meetingDescription":{"type":"string","maxLength":5000,"nullable":true},"durationMinutes":{"type":"integer","exclusiveMinimum":0,"maximum":240,"default":30}},"required":["condition","meetingTitle"],"additionalProperties":false},"description":"Regras que liberam o agendamento automático na conversa."},"contractRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string","minLength":1,"maxLength":200},"criteria":{"type":"string","minLength":1,"maxLength":2000},"provider":{"type":"string","enum":["JURIDIQ","ZAPSIGN"]},"templateId":{"type":"string","minLength":1},"templateName":{"type":"string","maxLength":255,"nullable":true},"extraTemplates":{"type":"array","items":{"type":"object","properties":{"templateId":{"type":"string","minLength":1},"templateName":{"type":"string","maxLength":255,"nullable":true}},"required":["templateId"],"additionalProperties":false},"maxItems":5,"default":[]},"fields":{"type":"object","additionalProperties":{"anyOf":[{"type":"object","properties":{"client":{"type":"string","enum":["name","document","rg","birthDate","maritalStatus","profession","nationality","email","phone","zipCode","streetAndNumber","neighborhood","city","state","address"]}},"required":["client"],"additionalProperties":false},{"type":"object","properties":{"person2":{"type":"string","enum":["name","document","rg","birthDate","maritalStatus","profession","nationality","email","phone","zipCode","streetAndNumber","neighborhood","city","state","address"]}},"required":["person2"],"additionalProperties":false},{"type":"object","properties":{"custom":{"type":"string","minLength":1,"maxLength":64}},"required":["custom"],"additionalProperties":false},{"type":"object","properties":{"fixed":{"type":"string","maxLength":5000}},"required":["fixed"],"additionalProperties":false}]},"default":{}},"requireSelfie":{"type":"boolean","default":false},"requireDocument":{"type":"boolean","default":false},"expiresInDays":{"type":"integer","minimum":1,"maximum":365,"nullable":true},"enabled":{"type":"boolean","default":true},"priority":{"type":"integer","nullable":true,"default":0}},"required":["name","criteria","provider","templateId"],"additionalProperties":false},"description":"Contratos que o agente pode enviar para assinatura. Lista vazia apaga todos."},"ticketRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"condition":{"type":"string","enum":["KEYWORDS","SENTIMENT","INTERACTION_COUNT","RESPONSE_TIME","CUSTOM"]},"keywords":{"type":"array","items":{"type":"string"},"default":[]},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"enabled":{"type":"boolean","default":true},"priority":{"type":"number","nullable":true,"default":0},"ticketTitle":{"type":"string","minLength":1},"ticketDescription":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"default":"LOW"},"statusId":{"type":"string","nullable":true},"assigneeIds":{"type":"array","items":{"type":"string"},"default":[]},"departmentIds":{"type":"array","items":{"type":"string"},"default":[]}},"required":["condition","ticketTitle"],"additionalProperties":false}},"tagRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"condition":{"type":"string","enum":["KEYWORDS","SENTIMENT","INTERACTION_COUNT","CUSTOM","MEETING_SCHEDULED","CONTRACT_SENT","CONTRACT_SIGNED"]},"keywords":{"type":"array","items":{"type":"string"},"default":[]},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"default":[]},"enabled":{"type":"boolean","default":true},"priority":{"type":"number","nullable":true,"default":0}},"required":["condition"],"additionalProperties":false}},"crmRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"condition":{"type":"string","enum":["KEYWORDS","SENTIMENT","INTERACTION_COUNT","CUSTOM","MEETING_SCHEDULED","CONTRACT_SENT","CONTRACT_SIGNED"]},"keywords":{"type":"array","items":{"type":"string"},"default":[]},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"enabled":{"type":"boolean","default":true},"priority":{"type":"number","nullable":true,"default":0}},"required":["condition","funnelColumnId"],"additionalProperties":false}},"customSchedule":{"type":"array","items":{"type":"object","properties":{"dayOfWeek":{"type":"string","enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"]},"enabled":{"type":"boolean","default":false},"startTime":{"type":"string","pattern":"^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$"},"endTime":{"type":"string","pattern":"^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$"}},"required":["dayOfWeek","startTime","endTime"],"additionalProperties":false}}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do agente."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string"},"avatarUrl":{"type":"string","nullable":true},"communicationStyle":{"type":"string"},"behavior":{"type":"string"},"purpose":{"type":"string"},"productName":{"type":"string","nullable":true},"productSite":{"type":"string","nullable":true},"agentModelId":{"type":"string"},"productDescription":{"type":"string","nullable":true},"canRequestHumanHelp":{"type":"boolean"},"canCreateTickets":{"type":"boolean"},"restrictToAllowedTopics":{"type":"boolean"},"activationKeywords":{"type":"array","items":{"type":"string"}},"responseDelaySeconds":{"type":"number","nullable":true},"maxInteractionsPerSession":{"type":"number","nullable":true},"endTriggerResolvedIntentEnabled":{"type":"boolean"},"endTriggerUserRequestEnabled":{"type":"boolean"},"endTriggerInactivityEnabled":{"type":"boolean"},"endTriggerInactivityMinutes":{"type":"number","nullable":true},"endTriggerAction":{"type":"string"},"endTriggerFarewellMessage":{"type":"string","nullable":true},"inboxId":{"type":"string"},"activePeriodEnabled":{"type":"boolean"},"activePeriodPreset":{"type":"string","nullable":true},"allowConsultingProcesses":{"type":"boolean"},"canScheduleMeetings":{"type":"boolean"},"calendarId":{"type":"string","nullable":true},"schedulingScheduleEnabled":{"type":"boolean"},"schedulingSchedule":{"nullable":true},"schedulingSlotDurationMinutes":{"type":"number"},"schedulingAllowOverlap":{"type":"boolean"},"schedulingMaxPerSlot":{"type":"number"},"schedulingMinAdvanceMinutes":{"type":"number"},"schedulingMaxAdvanceDays":{"type":"number"},"schedulingRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number"},"meetingTitle":{"type":"string"},"meetingDescription":{"type":"string","nullable":true},"durationMinutes":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","condition","keywords","sentimentThreshold","interactionCount","responseTimeMinutes","customCondition","enabled","priority","meetingTitle","meetingDescription","durationMinutes","createdAt","updatedAt"],"additionalProperties":false}},"canSendContracts":{"type":"boolean"},"contractRules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"criteria":{"type":"string"},"provider":{"type":"string"},"templateId":{"type":"string"},"templateName":{"type":"string","nullable":true},"extraTemplates":{},"fields":{},"requireSelfie":{"type":"boolean"},"requireDocument":{"type":"boolean"},"expiresInDays":{"type":"number","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","criteria","provider","templateId","templateName","requireSelfie","requireDocument","expiresInDays","enabled","priority","createdAt","updatedAt"],"additionalProperties":false}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"idleActions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"timeoutMinutes":{"type":"number","nullable":true},"maxAttempts":{"type":"number"},"action":{"type":"string"},"customMessage":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number","nullable":true},"followUpTopics":{"type":"array","items":{"type":"string"}},"skipFollowUpTopics":{"type":"array","items":{"type":"string"}}},"required":["id","timeoutMinutes","maxAttempts","action","customMessage","enabled","priority","followUpTopics","skipFollowUpTopics"],"additionalProperties":false}},"transferRules":{"type":"array","items":{"type":"object","properties":{"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"transferMessage":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number"},"userId":{"type":"string","nullable":true},"roleId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"distributeByChannel":{"type":"boolean"}},"required":["condition","keywords","sentimentThreshold","interactionCount","responseTimeMinutes","customCondition","transferMessage","enabled","priority","userId","roleId","departmentId","distributeByChannel"],"additionalProperties":false}},"ticketRules":{"type":"array","items":{"type":"object","properties":{"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"responseTimeMinutes":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"enabled":{"type":"boolean"},"priority":{"type":"number"},"ticketTitle":{"type":"string"},"ticketDescription":{"type":"string","nullable":true},"ticketPriority":{"type":"string"},"statusId":{"type":"string","nullable":true},"assigneeIds":{"type":"array","items":{"type":"string"}},"departmentIds":{"type":"array","items":{"type":"string"}}},"required":["condition","keywords","sentimentThreshold","interactionCount","responseTimeMinutes","customCondition","enabled","priority","ticketTitle","ticketDescription","ticketPriority","statusId","assigneeIds","departmentIds"],"additionalProperties":false}},"tagRules":{"type":"array","items":{"type":"object","properties":{"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"tagIds":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"priority":{"type":"number"}},"required":["condition","keywords","sentimentThreshold","interactionCount","customCondition","tagIds","enabled","priority"],"additionalProperties":false}},"crmRules":{"type":"array","items":{"type":"object","properties":{"condition":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sentimentThreshold":{"type":"number","nullable":true},"interactionCount":{"type":"number","nullable":true},"customCondition":{"type":"string","nullable":true},"funnelColumnId":{"type":"string"},"enabled":{"type":"boolean"},"priority":{"type":"number"}},"required":["condition","keywords","sentimentThreshold","interactionCount","customCondition","funnelColumnId","enabled","priority"],"additionalProperties":false}},"customSchedule":{"type":"array","items":{"type":"object","properties":{"dayOfWeek":{"type":"string"},"enabled":{"type":"boolean"},"startTime":{"type":"string"},"endTime":{"type":"string"}},"required":["dayOfWeek","enabled","startTime","endTime"],"additionalProperties":false},"nullable":true}},"required":["id","name","avatarUrl","communicationStyle","behavior","purpose","productName","productSite","agentModelId","productDescription","canRequestHumanHelp","canCreateTickets","restrictToAllowedTopics","activationKeywords","responseDelaySeconds","maxInteractionsPerSession","endTriggerResolvedIntentEnabled","endTriggerUserRequestEnabled","endTriggerInactivityEnabled","endTriggerInactivityMinutes","endTriggerAction","endTriggerFarewellMessage","inboxId","activePeriodEnabled","activePeriodPreset","allowConsultingProcesses","canScheduleMeetings","calendarId","schedulingScheduleEnabled","schedulingSlotDurationMinutes","schedulingAllowOverlap","schedulingMaxPerSlot","schedulingMinAdvanceMinutes","schedulingMaxAdvanceDays","schedulingRules","canSendContracts","contractRules","createdAt","updatedAt","idleActions","transferRules","ticketRules","tagRules","crmRules","customSchedule"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/agents/{agentId}/trainings":{"get":{"summary":"Listar treinamentos do agente","tags":["Agent Trainings"],"description":"Lista todos os treinamentos de um agente com paginação e filtros","parameters":[{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Número da página."},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":10},"in":"query","name":"limit","required":false,"description":"Quantidade de itens por página."},{"schema":{"type":"string"},"in":"query","name":"search","required":false,"description":"Busca por pergunta ou resposta."},{"schema":{"type":"string"},"in":"query","name":"isActive","required":false,"description":"Filtra treinamentos ativos (true) ou inativos (false)."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"agentId","required":true,"description":"ID do agente."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"question":{"type":"string"},"answer":{"type":"string"},"isActive":{"type":"boolean"},"agentId":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","question","answer","isActive","agentId","createdAt","updatedAt"],"additionalProperties":false}},"totalResults":{"type":"number"},"totalPages":{"type":"number"},"currentPage":{"type":"number"},"limit":{"type":"number"}},"required":["data","totalResults","totalPages","currentPage","limit"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Criar treinamento do agente","tags":["Agent Trainings"],"description":"Cria um novo treinamento para o agente","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string","minLength":1,"maxLength":1000,"description":"Pergunta do treinamento."},"answer":{"type":"string","minLength":1,"maxLength":3000,"description":"Resposta esperada do agente."},"isActive":{"type":"boolean","default":true,"description":"Indica se o treinamento está ativo."}},"required":["question","answer"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"agentId","required":true,"description":"ID do agente."}],"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"question":{"type":"string"},"answer":{"type":"string"},"isActive":{"type":"boolean"},"agentId":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","question","answer","isActive","agentId","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/agents/{agentId}/trainings/{id}":{"patch":{"summary":"Atualizar treinamento do agente","tags":["Agent Trainings"],"description":"Atualiza um treinamento existente do agente","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string","minLength":1,"maxLength":1000,"description":"Pergunta do treinamento."},"answer":{"type":"string","minLength":1,"maxLength":3000,"description":"Resposta esperada do agente."},"isActive":{"type":"boolean","description":"Indica se o treinamento está ativo."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"agentId","required":true,"description":"ID do agente."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do treinamento."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"question":{"type":"string"},"answer":{"type":"string"},"isActive":{"type":"boolean"},"agentId":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","question","answer","isActive","agentId","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Deletar treinamento do agente","tags":["Agent Trainings"],"description":"Remove um treinamento do agente","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"agentId","required":true,"description":"ID do agente."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do treinamento."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/tag/{id}":{"get":{"summary":"Obter tag","tags":["Tags"],"description":"Retorna os dados de uma tag pelo ID.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID da tag."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID da tag."},"name":{"type":"string","description":"Nome da tag."},"color":{"type":"string","description":"Cor da tag (ex.: código hexadecimal)."},"officeId":{"type":"string","description":"ID do escritório ao qual a tag pertence."},"inboxId":{"type":"string","description":"ID da inbox à qual a tag está vinculada."},"modules":{"type":"array","items":{"type":"string","enum":["crm","conversas","pessoas","fast-messages","tickets"]},"description":"Módulos onde a tag está disponível."}},"required":["id","name","color","officeId","inboxId","modules"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Atualizar tag","tags":["Tags"],"description":"Atualização parcial de nome, cor e/ou módulos de visibilidade da tag.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Novo nome da tag."},"color":{"type":"string","description":"Nova cor da tag (ex.: código hexadecimal)."},"modules":{"type":"array","items":{"type":"string","enum":["crm","conversas","pessoas","fast-messages","tickets"]},"description":"Módulos onde a tag estará disponível. Substitui a lista atual quando enviado."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID da tag."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID da tag."},"name":{"type":"string","description":"Nome da tag."},"color":{"type":"string","description":"Cor da tag."},"inboxId":{"type":"string","description":"ID da inbox à qual a tag está vinculada."},"officeId":{"type":"string","description":"ID do escritório ao qual a tag pertence."},"modules":{"type":"array","items":{"type":"string","enum":["crm","conversas","pessoas","fast-messages","tickets"]},"description":"Módulos onde a tag está disponível."}},"required":["id","name","color","inboxId","officeId","modules"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir tag","tags":["Tags"],"description":"Remove a tag pelo ID. Retorna 204 sem corpo em caso de sucesso.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID da tag a ser excluída."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/tag/":{"post":{"summary":"Criar tag","tags":["Tags"],"description":"Cria uma tag vinculada à inbox informada, com cor e visibilidade por módulos.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome da tag."},"color":{"type":"string","description":"Cor da tag (ex.: código hexadecimal)."},"inboxId":{"type":"string","description":"ID da inbox onde a tag será criada."},"modules":{"type":"array","items":{"type":"string","enum":["crm","conversas","pessoas","fast-messages","tickets"]},"description":"Módulos onde a tag estará disponível: crm, conversas, pessoas ou fast-messages."}},"required":["name","color","inboxId","modules"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID da tag criada."},"name":{"type":"string","description":"Nome da tag."},"color":{"type":"string","description":"Cor da tag."},"inboxId":{"type":"string","description":"ID da inbox à qual a tag está vinculada."},"officeId":{"type":"string","description":"ID do escritório ao qual a tag pertence."},"modules":{"type":"array","items":{"type":"string","enum":["crm","conversas","pessoas","fast-messages","tickets"]},"description":"Módulos onde a tag está disponível."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","color","inboxId","officeId","modules","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"get":{"summary":"Listar tags","tags":["Tags"],"description":"Retorna todas as tags vinculadas à inbox informada, com módulos de visibilidade e cor.","parameters":[{"schema":{"type":"string"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox. Retorna as tags vinculadas a essa caixa."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da tag."},"name":{"type":"string","description":"Nome da tag."},"color":{"type":"string","description":"Cor da tag (ex.: código hexadecimal)."},"officeId":{"type":"string","description":"ID do escritório ao qual a tag pertence."},"inboxId":{"type":"string","description":"ID da inbox à qual a tag está vinculada."},"modules":{"type":"array","items":{"type":"string","enum":["crm","conversas","pessoas","fast-messages","tickets"]},"description":"Módulos onde a tag está disponível: crm, conversas, pessoas ou fast-messages."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","color","officeId","inboxId","modules","createdAt","updatedAt"],"additionalProperties":false}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/tag/merge":{"post":{"summary":"Unificar etiquetas","tags":["Tags"],"description":"Une uma ou mais etiquetas de origem em uma etiqueta de destino, reatribuindo todos os vínculos (conversas, pessoas, cards do CRM, respostas rápidas e regras de agente) e removendo as etiquetas de origem.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"targetTagId":{"type":"string","description":"ID da etiqueta de destino que permanecerá após a unificação."},"sourceTagIds":{"type":"array","items":{"type":"string"},"minItems":1,"description":"IDs das etiquetas de origem que serão unificadas na etiqueta de destino e removidas."}},"required":["targetTagId","sourceTagIds"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID da etiqueta de destino."},"name":{"type":"string","description":"Nome da etiqueta de destino."},"color":{"type":"string","description":"Cor da etiqueta de destino."},"inboxId":{"type":"string","description":"ID da inbox à qual a etiqueta está vinculada."},"officeId":{"type":"string","description":"ID do escritório ao qual a etiqueta pertence."},"modules":{"type":"array","items":{"type":"string","enum":["crm","conversas","pessoas","fast-messages","tickets"]},"description":"Módulos onde a etiqueta de destino está disponível após a unificação."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","color","inboxId","officeId","modules","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/fast-message/send-batch":{"post":{"summary":"Enviar várias respostas rápidas em sequência","tags":["FastMessages"],"description":"Envia as respostas rápidas escolhidas, uma após a outra, na ordem informada. A primeira sai antes da resposta, então falha de canal volta aqui. O ritmo é o automático do provedor: para ritmo próprio, use uma resposta rápida do tipo `SEQUENCE`. As variáveis `{{Contato.*}}` do texto e da legenda saem com os dados do contato da conversa, e a que ele não tem sai em branco; um texto que fica vazio assim recusa o lote inteiro com 400, antes de qualquer envio.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","minLength":1,"description":"ID da conversa que vai receber as mensagens."},"fastMessageIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":20,"description":"IDs das respostas rápidas, na ordem em que devem ser enviadas."}},"required":["conversationId","fastMessageIds"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"sentNow":{"type":"integer","description":"Mensagens já entregues quando esta resposta saiu."},"scheduled":{"type":"integer","description":"Mensagens que continuam saindo depois desta resposta."}},"required":["sentNow","scheduled"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/fast-message/{id}/send":{"post":{"summary":"Disparar resposta rápida em sequência","tags":["FastMessages"],"description":"Envia a sequência na conversa informada. O primeiro bloco sai antes da resposta, então falha de canal volta aqui; os demais seguem em segundo plano, no ritmo definido em cada bloco. Quando solicitado, o atendimento é encerrado somente após a entrega do último bloco. As variáveis `{{Contato.*}}` dos blocos de texto saem com os dados do contato da conversa, e a que ele não tem sai em branco; um bloco que fica vazio assim recusa a sequência com 400, antes de qualquer envio.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","minLength":1,"description":"ID da conversa que vai receber a sequência."},"endConversationAfterSend":{"type":"boolean","description":"Encerra o atendimento humano somente após entregar o último bloco."}},"required":["conversationId"],"additionalProperties":false}}},"required":true},"parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true,"description":"ID da resposta rápida em sequência."}],"security":[{"apiKeyAuth":[]}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"sentNow":{"type":"integer","description":"Blocos já entregues quando esta resposta saiu."},"scheduled":{"type":"integer","description":"Blocos que continuam saindo depois desta resposta."}},"required":["sentNow","scheduled"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/fast-message/":{"get":{"summary":"Listar mensagens rápidas","tags":["FastMessages"],"description":"Lista as mensagens rápidas da inbox. Filtros opcionais por título e tags.","parameters":[{"schema":{"type":"string"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox. Obrigatório para filtrar as mensagens rápidas."},{"schema":{"type":"string"},"in":"query","name":"title","required":false,"description":"Filtra por título (correspondência parcial)."},{"schema":{"type":"array","items":{"type":"string"}},"in":"query","name":"tag","required":false,"description":"Filtra por IDs de tags."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da mensagem rápida."},"title":{"type":"string","description":"Título da mensagem rápida."},"type":{"type":"string","enum":["TEXT","AUDIO","IMAGE","VIDEO","DOCUMENT","SEQUENCE"],"description":"Tipo da mensagem rápida. `SEQUENCE` envia vários blocos em ordem, um por mensagem."},"content":{"type":"string","nullable":true,"description":"Texto da mensagem. Null quando é mídia."},"metadata":{"type":"object","properties":{"url":{"type":"string","description":"URL assinada do áudio."},"mimeType":{"type":"string","minLength":1,"description":"MIME type da mídia salva."},"duration":{"type":"integer","exclusiveMinimum":0,"nullable":true,"description":"Duração em segundos. Null quando não foi possível medir."},"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"Nome original do arquivo, como o cliente vê. Obrigatório quando `type` é `DOCUMENT`."}},"required":["url","mimeType"],"additionalProperties":false,"nullable":true,"description":"Dados da mídia, com a URL já assinada. Null quando é texto."},"supportedChannels":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Canais que aceitam esse formato de mídia. Null quando é texto."},"blocks":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["TEXT","AUDIO"],"description":"Formato deste bloco."},"content":{"type":"string","nullable":true,"description":"Texto do bloco. Null quando é áudio."},"metadata":{"type":"object","properties":{"url":{"type":"string","description":"URL assinada do áudio."},"mimeType":{"type":"string","minLength":1,"description":"MIME type da mídia salva."},"duration":{"type":"integer","nullable":true,"description":"Duração em segundos."},"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"Nome original do arquivo, como o cliente vê. Obrigatório quando `type` é `DOCUMENT`."}},"required":["url","mimeType","duration"],"additionalProperties":false,"nullable":true,"description":"Dados do áudio, com a URL já assinada. Null quando é texto."},"typingSeconds":{"type":"integer","description":"Segundos exibindo \"digitando\" antes deste bloco sair."},"waitSeconds":{"type":"integer","description":"Segundos de espera depois deste bloco, antes do próximo."}},"required":["type","content","metadata","typingSeconds","waitSeconds"],"additionalProperties":false},"nullable":true,"description":"Blocos da sequência, em ordem. Null quando não é sequência."},"inboxId":{"type":"string","description":"ID da inbox à qual a mensagem rápida pertence."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."},"tag":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da tag."},"name":{"type":"string","description":"Nome da tag."},"color":{"type":"string","description":"Cor da tag (ex.: código hexadecimal)."}},"required":["id","name","color"],"additionalProperties":false},"description":"Tags associadas à mensagem rápida."}},"required":["id","title","type","content","metadata","supportedChannels","blocks","inboxId","createdAt","updatedAt","tag"],"additionalProperties":false}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Criar mensagem rápida","tags":["FastMessages"],"description":"Cria uma mensagem rápida vinculada à inbox informada. `type: TEXT` usa `content`; `type: AUDIO` usa `metadata`; `IMAGE`, `VIDEO` e `DOCUMENT` usam `metadata` e aceitam `content` como legenda. `DOCUMENT` exige `metadata.fileName`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"description":"Título da mensagem rápida."},"type":{"type":"string","enum":["TEXT","AUDIO","IMAGE","VIDEO","DOCUMENT","SEQUENCE"],"description":"Tipo da mensagem rápida. `SEQUENCE` envia vários blocos em ordem, um por mensagem.","default":"TEXT"},"content":{"type":"string","description":"Texto da mensagem rápida ou legenda opcional de imagem, vídeo ou documento. Obrigatório quando `type` é `TEXT`. Aceita as variáveis `{{Contato.NomeCompleto}}`, `{{Contato.PrimeiroNome}}`, `{{Contato.Telefone}}`, `{{Contato.Documento}}` e `{{Contato.DataCriacao}}`, trocadas pelos dados do contato no envio."},"metadata":{"type":"object","properties":{"url":{"type":"string","minLength":1,"description":"Caminho da mídia no storage, ou a URL assinada que a listagem devolveu. Grava-se sempre o caminho."},"mimeType":{"type":"string","minLength":1,"description":"MIME type da mídia salva."},"duration":{"type":"integer","exclusiveMinimum":0,"nullable":true,"description":"Duração em segundos. Null quando não foi possível medir."},"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"Nome original do arquivo, como o cliente vê. Obrigatório quando `type` é `DOCUMENT`."}},"required":["url","mimeType"],"additionalProperties":false,"description":"Dados da mídia. Obrigatório para áudio, imagem, vídeo e documento (`DOCUMENT` exige `fileName`). O `url` é o caminho devolvido pelo endpoint de upload correspondente."},"blocks":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"content":{"type":"string","maxLength":4096,"nullable":true,"description":"Texto do bloco. Obrigatório quando `type` é `TEXT`."},"metadata":{"type":"object","properties":{"url":{"type":"string","minLength":1,"description":"Caminho da mídia no storage, ou a URL assinada que a listagem devolveu. Grava-se sempre o caminho."},"mimeType":{"type":"string","minLength":1,"description":"MIME type da mídia salva."},"duration":{"type":"integer","exclusiveMinimum":0,"nullable":true,"description":"Duração em segundos. Null quando não foi possível medir."},"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"Nome original do arquivo, como o cliente vê. Obrigatório quando `type` é `DOCUMENT`."}},"required":["url","mimeType"],"additionalProperties":false,"nullable":true,"description":"Dados do áudio. Obrigatório quando `type` é `AUDIO`."},"typingSeconds":{"type":"integer","minimum":0,"maximum":30,"default":0,"description":"Segundos exibindo \"digitando\" ao cliente antes deste bloco sair."},"waitSeconds":{"type":"integer","minimum":0,"maximum":300,"default":0,"description":"Segundos de espera depois deste bloco, antes do próximo."},"type":{"type":"string","enum":["TEXT"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"content":{"type":"string","maxLength":4096,"nullable":true,"description":"Texto do bloco. Obrigatório quando `type` é `TEXT`."},"metadata":{"type":"object","properties":{"url":{"type":"string","minLength":1,"description":"Caminho da mídia no storage, ou a URL assinada que a listagem devolveu. Grava-se sempre o caminho."},"mimeType":{"type":"string","minLength":1,"description":"MIME type da mídia salva."},"duration":{"type":"integer","exclusiveMinimum":0,"nullable":true,"description":"Duração em segundos. Null quando não foi possível medir."},"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"Nome original do arquivo, como o cliente vê. Obrigatório quando `type` é `DOCUMENT`."}},"required":["url","mimeType"],"additionalProperties":false,"nullable":true,"description":"Dados do áudio. Obrigatório quando `type` é `AUDIO`."},"typingSeconds":{"type":"integer","minimum":0,"maximum":30,"default":0,"description":"Segundos exibindo \"digitando\" ao cliente antes deste bloco sair."},"waitSeconds":{"type":"integer","minimum":0,"maximum":300,"default":0,"description":"Segundos de espera depois deste bloco, antes do próximo."},"type":{"type":"string","enum":["AUDIO"]}},"required":["type"],"additionalProperties":false}]},"minItems":1,"maxItems":20,"description":"Blocos da sequência. Obrigatório quando `type` é `SEQUENCE`."},"inboxId":{"type":"string","description":"ID da inbox à qual a mensagem rápida será vinculada."},"tagId":{"type":"array","items":{"type":"string"},"description":"IDs das tags associadas. Opcional."}},"required":["title","inboxId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID da mensagem rápida."},"title":{"type":"string","description":"Título da mensagem rápida."},"type":{"type":"string","enum":["TEXT","AUDIO","IMAGE","VIDEO","DOCUMENT","SEQUENCE"],"description":"Tipo da mensagem rápida. `SEQUENCE` envia vários blocos em ordem, um por mensagem."},"content":{"type":"string","nullable":true,"description":"Texto da mensagem. Null quando é mídia."},"metadata":{"type":"object","properties":{"url":{"type":"string","description":"URL assinada do áudio."},"mimeType":{"type":"string","minLength":1,"description":"MIME type da mídia salva."},"duration":{"type":"integer","exclusiveMinimum":0,"nullable":true,"description":"Duração em segundos. Null quando não foi possível medir."},"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"Nome original do arquivo, como o cliente vê. Obrigatório quando `type` é `DOCUMENT`."}},"required":["url","mimeType"],"additionalProperties":false,"nullable":true,"description":"Dados da mídia, com a URL já assinada. Null quando é texto."},"supportedChannels":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Canais que aceitam esse formato de mídia. Null quando é texto."},"blocks":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["TEXT","AUDIO"],"description":"Formato deste bloco."},"content":{"type":"string","nullable":true,"description":"Texto do bloco. Null quando é áudio."},"metadata":{"type":"object","properties":{"url":{"type":"string","description":"URL assinada do áudio."},"mimeType":{"type":"string","minLength":1,"description":"MIME type da mídia salva."},"duration":{"type":"integer","nullable":true,"description":"Duração em segundos."},"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"Nome original do arquivo, como o cliente vê. Obrigatório quando `type` é `DOCUMENT`."}},"required":["url","mimeType","duration"],"additionalProperties":false,"nullable":true,"description":"Dados do áudio, com a URL já assinada. Null quando é texto."},"typingSeconds":{"type":"integer","description":"Segundos exibindo \"digitando\" antes deste bloco sair."},"waitSeconds":{"type":"integer","description":"Segundos de espera depois deste bloco, antes do próximo."}},"required":["type","content","metadata","typingSeconds","waitSeconds"],"additionalProperties":false},"nullable":true,"description":"Blocos da sequência, em ordem. Null quando não é sequência."},"inboxId":{"type":"string","description":"ID da inbox à qual a mensagem rápida pertence."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","title","type","content","metadata","supportedChannels","blocks","inboxId","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/fast-message/audio":{"post":{"summary":"Enviar áudio de mensagem rápida","tags":["FastMessages"],"description":"Sobe o áudio da mensagem rápida (`multipart/form-data` com `file` e `inboxId`) e devolve o caminho no storage para usar em `audioUrl` na criação ou atualização.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"storagePath":{"type":"string","description":"Caminho do áudio no storage. É o valor a enviar em `audioUrl`."},"previewUrl":{"type":"string","description":"URL assinada para ouvir o áudio antes de salvar."},"mimeType":{"type":"string","description":"MIME type do áudio enviado."},"fileName":{"type":"string","description":"Nome final do arquivo salvo."},"supportedChannels":{"type":"array","items":{"type":"string"},"description":"Canais que conseguem entregar esse formato de áudio. Formatos que não são aceitos pela Meta ou pelo Instagram saem sem esses canais na lista."}},"required":["storagePath","previewUrl","mimeType","fileName","supportedChannels"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/fast-message/media":{"post":{"summary":"Enviar imagem, vídeo ou documento de mensagem rápida","tags":["FastMessages"],"description":"Sobe a mídia (`multipart/form-data` com `file`, `inboxId` e `type`) e devolve o caminho no storage.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"storagePath":{"type":"string","description":"Caminho da mídia no storage."},"previewUrl":{"type":"string","description":"URL assinada para visualizar a mídia antes de salvar."},"mimeType":{"type":"string","description":"MIME type da mídia enviada."},"fileName":{"type":"string","description":"Nome final do arquivo salvo."},"supportedChannels":{"type":"array","items":{"type":"string"},"description":"Canais que entregam esse formato."}},"required":["storagePath","previewUrl","mimeType","fileName","supportedChannels"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/fast-message/{id}":{"patch":{"summary":"Atualizar mensagem rápida","tags":["FastMessages"],"description":"Atualização parcial: apenas os campos enviados são modificados. Trocar de `type` limpa o conteúdo do tipo anterior.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","description":"Novo título da mensagem rápida."},"type":{"type":"string","enum":["TEXT","AUDIO","IMAGE","VIDEO","DOCUMENT","SEQUENCE"],"description":"Novo tipo. Trocar de tipo limpa o conteúdo do tipo anterior."},"content":{"type":"string","description":"Novo texto ou legenda opcional de imagem, vídeo ou documento. Aceita as variáveis `{{Contato.NomeCompleto}}`, `{{Contato.PrimeiroNome}}`, `{{Contato.Telefone}}`, `{{Contato.Documento}}` e `{{Contato.DataCriacao}}`, trocadas pelos dados do contato no envio."},"metadata":{"type":"object","properties":{"url":{"type":"string","minLength":1,"description":"Caminho da mídia no storage, ou a URL assinada que a listagem devolveu. Grava-se sempre o caminho."},"mimeType":{"type":"string","minLength":1,"description":"MIME type da mídia salva."},"duration":{"type":"integer","exclusiveMinimum":0,"nullable":true,"description":"Duração em segundos. Null quando não foi possível medir."},"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"Nome original do arquivo, como o cliente vê. Obrigatório quando `type` é `DOCUMENT`."}},"required":["url","mimeType"],"additionalProperties":false,"description":"Novos dados da mídia. Usado por áudio, imagem, vídeo ou documento (`DOCUMENT` exige `fileName`)."},"blocks":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"content":{"type":"string","maxLength":4096,"nullable":true,"description":"Texto do bloco. Obrigatório quando `type` é `TEXT`."},"metadata":{"type":"object","properties":{"url":{"type":"string","minLength":1,"description":"Caminho da mídia no storage, ou a URL assinada que a listagem devolveu. Grava-se sempre o caminho."},"mimeType":{"type":"string","minLength":1,"description":"MIME type da mídia salva."},"duration":{"type":"integer","exclusiveMinimum":0,"nullable":true,"description":"Duração em segundos. Null quando não foi possível medir."},"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"Nome original do arquivo, como o cliente vê. Obrigatório quando `type` é `DOCUMENT`."}},"required":["url","mimeType"],"additionalProperties":false,"nullable":true,"description":"Dados do áudio. Obrigatório quando `type` é `AUDIO`."},"typingSeconds":{"type":"integer","minimum":0,"maximum":30,"default":0,"description":"Segundos exibindo \"digitando\" ao cliente antes deste bloco sair."},"waitSeconds":{"type":"integer","minimum":0,"maximum":300,"default":0,"description":"Segundos de espera depois deste bloco, antes do próximo."},"type":{"type":"string","enum":["TEXT"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"content":{"type":"string","maxLength":4096,"nullable":true,"description":"Texto do bloco. Obrigatório quando `type` é `TEXT`."},"metadata":{"type":"object","properties":{"url":{"type":"string","minLength":1,"description":"Caminho da mídia no storage, ou a URL assinada que a listagem devolveu. Grava-se sempre o caminho."},"mimeType":{"type":"string","minLength":1,"description":"MIME type da mídia salva."},"duration":{"type":"integer","exclusiveMinimum":0,"nullable":true,"description":"Duração em segundos. Null quando não foi possível medir."},"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"Nome original do arquivo, como o cliente vê. Obrigatório quando `type` é `DOCUMENT`."}},"required":["url","mimeType"],"additionalProperties":false,"nullable":true,"description":"Dados do áudio. Obrigatório quando `type` é `AUDIO`."},"typingSeconds":{"type":"integer","minimum":0,"maximum":30,"default":0,"description":"Segundos exibindo \"digitando\" ao cliente antes deste bloco sair."},"waitSeconds":{"type":"integer","minimum":0,"maximum":300,"default":0,"description":"Segundos de espera depois deste bloco, antes do próximo."},"type":{"type":"string","enum":["AUDIO"]}},"required":["type"],"additionalProperties":false}]},"minItems":1,"maxItems":20,"description":"Novos blocos. Substitui a sequência inteira. Só com `type: SEQUENCE`."},"tagId":{"type":"array","items":{"type":"string"},"description":"IDs das tags. Substitui todas as tags atuais quando enviado."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID da mensagem rápida."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID da mensagem rápida."},"title":{"type":"string","description":"Título da mensagem rápida."},"type":{"type":"string","enum":["TEXT","AUDIO","IMAGE","VIDEO","DOCUMENT","SEQUENCE"],"description":"Tipo da mensagem rápida. `SEQUENCE` envia vários blocos em ordem, um por mensagem."},"content":{"type":"string","nullable":true,"description":"Texto da mensagem. Null quando é mídia."},"metadata":{"type":"object","properties":{"url":{"type":"string","description":"URL assinada do áudio."},"mimeType":{"type":"string","minLength":1,"description":"MIME type da mídia salva."},"duration":{"type":"integer","exclusiveMinimum":0,"nullable":true,"description":"Duração em segundos. Null quando não foi possível medir."},"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"Nome original do arquivo, como o cliente vê. Obrigatório quando `type` é `DOCUMENT`."}},"required":["url","mimeType"],"additionalProperties":false,"nullable":true,"description":"Dados da mídia, com a URL já assinada. Null quando é texto."},"supportedChannels":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Canais que aceitam esse formato de mídia. Null quando é texto."},"blocks":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["TEXT","AUDIO"],"description":"Formato deste bloco."},"content":{"type":"string","nullable":true,"description":"Texto do bloco. Null quando é áudio."},"metadata":{"type":"object","properties":{"url":{"type":"string","description":"URL assinada do áudio."},"mimeType":{"type":"string","minLength":1,"description":"MIME type da mídia salva."},"duration":{"type":"integer","nullable":true,"description":"Duração em segundos."},"fileName":{"type":"string","minLength":1,"maxLength":255,"description":"Nome original do arquivo, como o cliente vê. Obrigatório quando `type` é `DOCUMENT`."}},"required":["url","mimeType","duration"],"additionalProperties":false,"nullable":true,"description":"Dados do áudio, com a URL já assinada. Null quando é texto."},"typingSeconds":{"type":"integer","description":"Segundos exibindo \"digitando\" antes deste bloco sair."},"waitSeconds":{"type":"integer","description":"Segundos de espera depois deste bloco, antes do próximo."}},"required":["type","content","metadata","typingSeconds","waitSeconds"],"additionalProperties":false},"nullable":true,"description":"Blocos da sequência, em ordem. Null quando não é sequência."},"inboxId":{"type":"string","description":"ID da inbox à qual a mensagem rápida pertence."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."},"tag":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da tag."},"name":{"type":"string","description":"Nome da tag."},"color":{"type":"string","description":"Cor da tag (ex.: código hexadecimal)."}},"required":["id","name","color"],"additionalProperties":false},"description":"Tags associadas à mensagem rápida."}},"required":["id","title","type","content","metadata","supportedChannels","blocks","inboxId","createdAt","updatedAt","tag"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir mensagem rápida","tags":["FastMessages"],"description":"Remove a mensagem rápida pelo ID. Retorna 204 sem corpo em caso de sucesso.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID da mensagem rápida a ser excluída."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/funnel/":{"post":{"summary":"Criar funil","tags":["CRM"],"description":"Cria um novo funil de vendas","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Nome do funil."},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Nome da coluna."},"color":{"type":"string","minLength":1,"description":"Cor da coluna."},"index":{"type":"integer","minimum":0,"description":"Posição da coluna no funil."},"kind":{"type":"string","enum":["NORMAL","WON","LOST"],"description":"Tipo da coluna: NORMAL, WON ou LOST."}},"required":["name","color","index"],"additionalProperties":false},"description":"Colunas iniciais do funil."},"inboxId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da inbox vinculada ao funil."}},"required":["name","inboxId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"inboxId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"columns":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"color":{"type":"string"},"index":{"type":"number"},"kind":{"type":"string","enum":["NORMAL","WON","LOST"]}},"required":["name","color","index","kind"],"additionalProperties":false}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","inboxId","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"get":{"summary":"Listar funis","tags":["CRM"],"description":"Lista todos os funis do escritório.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox."},{"schema":{"type":"string"},"in":"query","name":"name","required":false,"description":"Filtra funis pelo nome."},{"schema":{"type":"string"},"in":"query","name":"userId","required":false,"description":"Ignorado: a listagem não filtra funis por responsável."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"columns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"index":{"type":"number"},"kind":{"type":"string","enum":["NORMAL","WON","LOST"]},"excludeFromMetrics":{"type":"boolean","description":"Cards desta coluna ficam fora do relatório comercial."}},"required":["id","name","color","index","kind","excludeFromMetrics"],"additionalProperties":false}},"cardConfig":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"description":"Identificador do campo. Campos personalizados usam `customField:<id>`."},"visible":{"type":"boolean","description":"Indica se o campo é exibido no card."}},"required":["id","visible"],"additionalProperties":false},"maxItems":50,"description":"Campos do card e sua ordem. `null` quando o funil usa o padrão.","nullable":true},"createdAt":{"type":"string","format":"date-time"},"inboxId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","cardConfig","createdAt","inboxId","updatedAt"],"additionalProperties":false}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/funnel/{id}":{"get":{"summary":"Obter funil","tags":["CRM"],"description":"Busca um funil específico pelo ID","parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"}}]},"in":"query","name":"responsible","required":false,"description":"Filtra cards por um ou mais responsáveis."},{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"page","required":false,"description":"Número da página."},{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"limit","required":false,"description":"Quantidade de cards por coluna."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do funil."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"columns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"index":{"type":"number"},"kind":{"type":"string","enum":["NORMAL","WON","LOST"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"channel":{"type":"string","nullable":true},"funnelId":{"type":"string"},"columnId":{"type":"string"},"userId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"person":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","createdAt","updatedAt"],"additionalProperties":false},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"options":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}]},"value":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}]}},"required":["id","name","type","value"],"additionalProperties":false}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","channel","funnelId","columnId","person","customFields","createdAt","updatedAt"],"additionalProperties":false}},"total":{"type":"number"},"page":{"type":"number"},"hasMore":{"type":"boolean"}},"required":["id","name","color","index","kind","items","total","page","hasMore"],"additionalProperties":false}},"cardConfig":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"description":"Identificador do campo. Campos personalizados usam `customField:<id>`."},"visible":{"type":"boolean","description":"Indica se o campo é exibido no card."}},"required":["id","visible"],"additionalProperties":false},"maxItems":50,"description":"Campos do card e sua ordem. `null` quando o funil usa o padrão.","nullable":true},"inboxId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","cardConfig","inboxId","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Atualizar funil","tags":["CRM"],"description":"Atualiza um funil existente","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Novo nome do funil."},"cardConfig":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"description":"Identificador do campo. Campos personalizados usam `customField:<id>`."},"visible":{"type":"boolean","description":"Indica se o campo é exibido no card."}},"required":["id","visible"],"additionalProperties":false},"maxItems":50,"description":"Array ordenado dos campos do card. A ordem do array define a ordem de exibição. Enviar `[]` restaura o padrão."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true,"description":"ID do funil."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"inboxId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"cardConfig":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"description":"Identificador do campo. Campos personalizados usam `customField:<id>`."},"visible":{"type":"boolean","description":"Indica se o campo é exibido no card."}},"required":["id","visible"],"additionalProperties":false},"maxItems":50,"description":"Array ordenado dos campos do card. A ordem do array define a ordem de exibição. Enviar `[]` restaura o padrão.","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","inboxId","cardConfig","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir funil","tags":["CRM"],"description":"Remove um funil existente","parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true,"description":"ID do funil."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"],"nullable":true}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/funnel-custom-field/":{"post":{"summary":"Criar campo personalizado","tags":["CRM"],"description":"Cria um novo campo personalizado no sistema","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome do campo personalizado."},"type":{"type":"string","description":"Tipo do campo (texto, select, data, etc.)."},"options":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"description":"Opções do campo, quando aplicável."},"required":{"type":"boolean","default":false,"description":"Se marcado, o card só sai da etapa inicial com este campo preenchido."},"requiredFromColumnId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","nullable":true,"description":"Etapa a partir da qual o campo obrigatório é exigido. Nulo = toda etapa menos a inicial."},"funnelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do funil."}},"required":["name","type","funnelId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string"},"type":{"type":"string"},"options":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}]},"required":{"type":"boolean"},"requiredFromColumnId":{"type":"string","nullable":true},"funnelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","type","required","requiredFromColumnId","funnelId","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"get":{"summary":"Obter todos os campos personalizados","tags":["CRM"],"description":"Obtém todos os campos personalizados de um funil.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"funnelId","required":true,"description":"ID do funil."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string"},"type":{"type":"string"},"options":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}]},"required":{"type":"boolean"},"requiredFromColumnId":{"type":"string","nullable":true},"funnelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","type","required","requiredFromColumnId","funnelId","createdAt","updatedAt"],"additionalProperties":false}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/funnel-custom-field/{id}":{"patch":{"summary":"Atualizar campo personalizado","tags":["CRM"],"description":"Atualiza um campo personalizado existente","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome do campo personalizado."},"type":{"type":"string","description":"Tipo do campo."},"options":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"description":"Opções do campo, quando aplicável."},"required":{"type":"boolean","description":"Se marcado, o card só sai da etapa inicial com este campo preenchido."},"requiredFromColumnId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","nullable":true,"description":"Etapa a partir da qual o campo obrigatório é exigido. Nulo = toda etapa menos a inicial."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do campo personalizado."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Confirmação da operação. Retorna `ok` em caso de sucesso.","content":{"application/json":{"schema":{"type":"string","description":"Confirmação da operação. Retorna `ok` em caso de sucesso."}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir campo personalizado","tags":["CRM"],"description":"Remove um campo personalizado existente","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do campo personalizado."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Confirmação da operação. Retorna `ok` em caso de sucesso.","content":{"application/json":{"schema":{"type":"string","description":"Confirmação da operação. Retorna `ok` em caso de sucesso."}}}}}}},"/funnel-column/":{"post":{"summary":"Criar coluna do funil","tags":["CRM"],"description":"Cria uma nova coluna do funil no sistema","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome da coluna."},"color":{"type":"string","description":"Cor da coluna."},"index":{"type":"integer","description":"Posição da coluna no funil."},"funnelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do funil."},"showBadgeProgress":{"type":"boolean","description":"Exibe badge de progresso na coluna."},"timeLimitDays":{"type":"integer","description":"Limite de dias do card nesta coluna."},"autoCreateJuridiqLead":{"type":"boolean","description":"Cria lead no Juridiq ao entrar nesta coluna."},"excludeFromMetrics":{"type":"boolean","description":"Cards desta coluna ficam fora do relatório comercial e do ganho/perda da Home."},"kind":{"type":"string","enum":["NORMAL","WON","LOST"],"description":"Tipo da coluna: NORMAL, WON ou LOST."}},"required":["name","color","index","funnelId","showBadgeProgress","timeLimitDays"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string"},"color":{"type":"string"},"index":{"type":"number"},"funnelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"showBadgeProgress":{"type":"boolean"},"timeLimitDays":{"type":"number"},"autoCreateJuridiqLead":{"type":"boolean"},"excludeFromMetrics":{"type":"boolean"},"kind":{"type":"string","enum":["NORMAL","WON","LOST"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","color","index","funnelId","showBadgeProgress","timeLimitDays","kind","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"get":{"summary":"Listar colunas do funil","tags":["CRM"],"description":"Lista as colunas do funil.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"funnelId","required":true,"description":"ID do funil."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"start","required":false,"description":"Início do período (ISO 8601, meia-noite local). Exige type."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"end","required":false,"description":"Fim do período (ISO 8601, meia-noite local do último dia). Opcional; sem end filtra a partir de start."},{"schema":{"type":"string","enum":["createdAt","lastInteraction"]},"in":"query","name":"type","required":false,"description":"Campo filtrado por start/end: criação do card no CRM ou última mensagem."},{"schema":{"type":"string"},"in":"query","name":"createdAt","required":false,"description":"Legado: filtra cards criados no dia desta data. Prefira start/end + type."},{"schema":{"type":"string"},"in":"query","name":"lastContact","required":false,"description":"Legado: filtra pelo último contato no dia desta data. Prefira start/end + type."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"userId","required":false,"description":"Filtra pelo responsável do card."},{"schema":{"type":"string"},"in":"query","name":"tags","required":false,"description":"IDs de etiquetas separados por vírgula."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"columnId","required":false,"description":"Filtra por uma coluna do funil."},{"schema":{"type":"string"},"in":"query","name":"channel","required":false,"description":"Filtra pelo canal do lead."},{"schema":{"type":"string"},"in":"query","name":"search","required":false,"description":"Busca por nome ou telefone do contato."},{"schema":{"type":"boolean"},"in":"query","name":"showOnlyUnread","required":false,"description":"Quando verdadeiro, retorna apenas os cards cujo contato tem mensagem não lida."},{"schema":{"type":"string","enum":["none","overdue"]},"in":"query","name":"ticketStatus","required":false,"description":"none: só contatos sem ticket em aberto. overdue: só contatos com ticket em aberto e data final vencida."},{"schema":{"type":"string","enum":["manual","name","createdAt","lastInteraction"]},"in":"query","name":"sortField","required":false,"description":"Campo de ordenação dos cards."},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"sortOrder","required":false,"description":"Direção da ordenação."},{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false,"description":"Número da página."},{"schema":{"type":"integer","minimum":1,"default":99999},"in":"query","name":"limit","required":false,"description":"Quantidade de cards por coluna."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"showBadgeProgress":{"type":"boolean"},"timeLimitDays":{"type":"number"},"autoCreateJuridiqLead":{"type":"boolean"},"excludeFromMetrics":{"type":"boolean"},"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"index":{"type":"number"},"kind":{"type":"string","enum":["NORMAL","WON","LOST"]},"funnelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"columnCards":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"columnChangedAt":{"type":"string","format":"date-time"},"id":{"type":"string"},"channel":{"type":"string","nullable":true},"columnId":{"type":"string"},"user":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string"}},"required":["id"],"additionalProperties":false,"nullable":true},"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","nullable":true},"unreadCount":{"type":"integer","minimum":0},"person":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"imageUrl":{"type":"string","nullable":true},"phoneNumber":{"type":"string","nullable":true}},"required":["id","name","email","imageUrl","phoneNumber"],"additionalProperties":false},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"value":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}]}},"required":["id","value"],"additionalProperties":false}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false}},"legalArea":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false,"nullable":true},"ticketStatus":{"type":"string","enum":["none","pending","overdue"],"description":"Tickets em aberto do contato: none (nenhum), pending (em dia) ou overdue (algum com data final vencida)."},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["columnChangedAt","id","channel","columnId","user","conversationId","unreadCount","person","customFields","tags","legalArea","ticketStatus","createdAt","updatedAt"],"additionalProperties":false}},"total":{"type":"number"},"page":{"type":"number"},"hasMore":{"type":"boolean"}},"required":["items","total","page","hasMore"],"additionalProperties":false},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["showBadgeProgress","timeLimitDays","id","name","color","index","kind","funnelId","columnCards","createdAt","updatedAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Deletar coluna do funil","tags":["CRM"],"description":"Remove uma ou mais colunas do funil existentes","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs das colunas a remover."}},"required":["ids"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Confirmação da operação. Retorna `ok` em caso de sucesso.","content":{"application/json":{"schema":{"type":"string","description":"Confirmação da operação. Retorna `ok` em caso de sucesso."}}}}}}},"/funnel-column/report":{"get":{"summary":"Gerar dados do relatório do funil","tags":["CRM"],"description":"Retorna os dados filtrados do funil de CRM usados nos relatórios em PDF e Excel.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"funnelId","required":true,"description":"ID do funil."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"start","required":false,"description":"Início do período (ISO 8601, meia-noite local). Exige type. Mesmo formato do filtro do board."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"end","required":false,"description":"Fim do período (ISO 8601, meia-noite local do último dia). Opcional; sem end filtra a partir de start."},{"schema":{"type":"string","enum":["createdAt","lastInteraction"]},"in":"query","name":"type","required":false,"description":"Campo filtrado por start/end: criação do card no CRM ou última mensagem."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"createdAt","required":false,"description":"Legado: filtra cards criados no dia desta data (ISO 8601). Prefira start/end + type."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"lastContact","required":false,"description":"Legado: filtra pelo último contato no dia desta data (ISO 8601). Prefira start/end + type."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"userId","required":false,"description":"Filtra pelo responsável do card."},{"schema":{"type":"string"},"in":"query","name":"tags","required":false,"description":"IDs de etiquetas separados por vírgula."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"columnId","required":false,"description":"Filtra por uma coluna do funil."},{"schema":{"type":"string"},"in":"query","name":"channel","required":false,"description":"Filtra pelo canal do lead."},{"schema":{"type":"string"},"in":"query","name":"search","required":false,"description":"Busca por nome ou telefone do contato."},{"schema":{"type":"boolean"},"in":"query","name":"showOnlyUnread","required":false,"description":"Quando verdadeiro, considera apenas os cards cujo contato tem mensagem não lida."},{"schema":{"type":"string","enum":["none","overdue"]},"in":"query","name":"ticketStatus","required":false,"description":"none: só contatos sem ticket em aberto. overdue: só contatos com ticket em aberto e data final vencida."},{"schema":{"type":"string","enum":["manual","name","createdAt","lastInteraction"]},"in":"query","name":"sortField","required":false,"description":"Campo de ordenação dos cards."},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"sortOrder","required":false,"description":"Direção da ordenação."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"funnel":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"columnId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"columnName":{"type":"string"},"channel":{"type":"string","nullable":true},"user":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string","nullable":true},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","imageUrl"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"phoneNumber":{"type":"string","nullable":true}},"required":["id","name","email","phoneNumber"],"additionalProperties":false},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"value":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}]}},"required":["id","value"],"additionalProperties":false}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"legalArea":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true},"createdAt":{"type":"string","format":"date-time"},"lastInteractionAt":{"type":"string","format":"date-time","nullable":true},"ticketStatus":{"type":"string","enum":["none","pending","overdue"],"description":"Tickets em aberto do contato: none (nenhum), pending (em dia) ou overdue (algum com data final vencida)."}},"required":["id","columnId","columnName","channel","user","person","customFields","tags","legalArea","createdAt","lastInteractionAt","ticketStatus"],"additionalProperties":false}}},"required":["funnel","data"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/funnel-column/report/summary":{"get":{"summary":"Resumo do relatório do funil","tags":["CRM"],"description":"Mesmos filtros do relatório, só com os totais e sem os cards de coluna fora das métricas (a lista do relatório os mantém). Usado para comparar com o período anterior sem carregar os leads.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"funnelId","required":true,"description":"ID do funil."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"start","required":false,"description":"Início do período (ISO 8601, meia-noite local). Exige type. Mesmo formato do filtro do board."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"end","required":false,"description":"Fim do período (ISO 8601, meia-noite local do último dia). Opcional; sem end filtra a partir de start."},{"schema":{"type":"string","enum":["createdAt","lastInteraction"]},"in":"query","name":"type","required":false,"description":"Campo filtrado por start/end: criação do card no CRM ou última mensagem."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"createdAt","required":false,"description":"Legado: filtra cards criados no dia desta data (ISO 8601). Prefira start/end + type."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"lastContact","required":false,"description":"Legado: filtra pelo último contato no dia desta data (ISO 8601). Prefira start/end + type."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"userId","required":false,"description":"Filtra pelo responsável do card."},{"schema":{"type":"string"},"in":"query","name":"tags","required":false,"description":"IDs de etiquetas separados por vírgula."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"columnId","required":false,"description":"Filtra por uma coluna do funil."},{"schema":{"type":"string"},"in":"query","name":"channel","required":false,"description":"Filtra pelo canal do lead."},{"schema":{"type":"string"},"in":"query","name":"search","required":false,"description":"Busca por nome ou telefone do contato."},{"schema":{"type":"boolean"},"in":"query","name":"showOnlyUnread","required":false,"description":"Quando verdadeiro, considera apenas os cards cujo contato tem mensagem não lida."},{"schema":{"type":"string","enum":["none","overdue"]},"in":"query","name":"ticketStatus","required":false,"description":"none: só contatos sem ticket em aberto. overdue: só contatos com ticket em aberto e data final vencida."},{"schema":{"type":"string","enum":["manual","name","createdAt","lastInteraction"]},"in":"query","name":"sortField","required":false,"description":"Campo de ordenação dos cards."},{"schema":{"type":"string","enum":["asc","desc"]},"in":"query","name":"sortOrder","required":false,"description":"Direção da ordenação."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"number","description":"Leads no período com os filtros, sem os de coluna fora das métricas."},"won":{"type":"number"},"lost":{"type":"number"},"open":{"type":"number"},"avgDaysToWon":{"type":"number","nullable":true,"description":"Dias, em média, entre a criação do card e a entrada numa coluna de ganho."}},"required":["total","won","lost","open","avgDaysToWon"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/funnel-column/report/flow":{"get":{"summary":"Fluxo do funil (tempo por coluna e movimentações)","tags":["CRM"],"description":"Agrega o histórico de colunas do funil: leads parados, permanência média por coluna, tempo até o ganho e últimas movimentações. Coluna fora das métricas não aparece, e o card que está nela fica fora dos números e das movimentações.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"funnelId","required":true,"description":"ID do funil."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"start","required":false,"description":"Início do período (ISO 8601, meia-noite local). Filtra as movimentações. Sem start/end, últimos 90 dias."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"end","required":false,"description":"Fim do período (ISO 8601, meia-noite local do último dia)."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"userId","required":false,"description":"Filtra pelo responsável do card."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"columnId","required":false,"description":"Filtra pelos cards que estão nesta coluna, como no relatório."},{"schema":{"type":"string"},"in":"query","name":"tags","required":false,"description":"IDs de etiquetas separados por vírgula."},{"schema":{"type":"string"},"in":"query","name":"channel","required":false,"description":"Filtra pelo canal do lead."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"columns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"current":{"type":"number","description":"Leads na coluna agora."},"stalled":{"type":"number","description":"Leads na coluna agora há mais tempo que o prazo da coluna; 0 quando a coluna não tem prazo (≤ 0)."},"avgCurrentDays":{"type":"number","nullable":true,"description":"Há quantos dias, em média, os leads de agora estão na coluna."},"entered":{"type":"number","description":"Entradas na coluna no período."},"avgStayDays":{"type":"number","nullable":true,"description":"Permanência média de quem entrou no período e já saiu."}},"required":["id","current","stalled","avgCurrentDays","entered","avgStayDays"],"additionalProperties":false}},"avgDaysToWon":{"type":"number","nullable":true,"description":"Dias, em média, entre a criação do card e a entrada numa coluna de ganho."},"movements":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string"},"personName":{"type":"string","nullable":true},"fromColumnId":{"type":"string","nullable":true},"toColumnId":{"type":"string"},"source":{"type":"string"},"userName":{"type":"string","nullable":true}},"required":["at","personName","fromColumnId","toColumnId","source","userName"],"additionalProperties":false}}},"required":["columns","avgDaysToWon","movements"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/funnel-column/report/contracts":{"get":{"summary":"Contratos fechados no período","tags":["CRM"],"description":"Contratos assinados do escritório no período (sem documentos de sandbox), com o autor do envio (usuário ou agente de IA).","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"start","required":false,"description":"Início do período (ISO 8601, meia-noite local). Filtra pela data da assinatura. Sem start/end, últimos 90 dias."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"end","required":false,"description":"Fim do período (ISO 8601, meia-noite local do último dia)."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"contracts":{"type":"array","items":{"type":"object","properties":{"signedAt":{"type":"string","description":"Quando o último signatário assinou."},"authorKind":{"type":"string","enum":["USER","AGENT","NONE"],"description":"Quem enviou o contrato: usuário, agente de IA ou ninguém identificado."},"authorId":{"type":"string","nullable":true},"authorName":{"type":"string","nullable":true}},"required":["signedAt","authorKind","authorId","authorName"],"additionalProperties":false}}},"required":["contracts"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/funnel-column/{id}":{"get":{"summary":"Obter coluna do funil","tags":["CRM"],"description":"Busca uma coluna de funil específica pelo ID","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID da coluna do funil."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"showBadgeProgress":{"type":"boolean"},"timeLimitDays":{"type":"number"},"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"index":{"type":"number"},"funnelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"columnCards":{"type":"array","items":{"type":"object","properties":{"columnChangedAt":{"type":"string","format":"date-time"},"id":{"type":"string"},"channel":{"type":"string","nullable":true},"columnId":{"type":"string"},"userId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","nullable":true},"user":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string","nullable":true},"imageUrl":{"type":"string","nullable":true},"role":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"document":{"type":"string","nullable":true}},"required":["id","name","imageUrl","role","email","document"],"additionalProperties":false,"nullable":true},"person":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"name":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"imageUrl":{"type":"string","nullable":true}},"required":["id","name","email","phone","imageUrl"],"additionalProperties":false},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"value":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}]}},"required":["id","value"],"additionalProperties":false}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false}}},"required":["columnChangedAt","id","channel","columnId","userId","user","person","customFields","tags"],"additionalProperties":false}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["showBadgeProgress","timeLimitDays","id","name","color","index","funnelId","columnCards","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Atualizar coluna do funil","tags":["CRM"],"description":"Atualiza uma coluna de funil existente","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Nome da coluna."},"color":{"type":"string","description":"Cor da coluna."},"index":{"type":"integer","description":"Posição da coluna no funil."},"showBadgeProgress":{"type":"boolean","description":"Exibe badge de progresso na coluna."},"timeLimitDays":{"type":"integer","description":"Limite de dias do card nesta coluna."},"autoCreateJuridiqLead":{"type":"boolean","description":"Cria lead no Juridiq ao entrar nesta coluna."},"excludeFromMetrics":{"type":"boolean","description":"Cards desta coluna ficam fora do relatório comercial e do ganho/perda da Home."},"kind":{"type":"string","enum":["NORMAL","WON","LOST"],"description":"Tipo da coluna: NORMAL, WON ou LOST."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID da coluna do funil."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"index":{"type":"number"},"showBadgeProgress":{"type":"boolean"},"timeLimitDays":{"type":"number"},"autoCreateJuridiqLead":{"type":"boolean"},"excludeFromMetrics":{"type":"boolean"},"kind":{"type":"string","enum":["NORMAL","WON","LOST"]},"funnelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","color","index","showBadgeProgress","timeLimitDays","kind","funnelId","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/funnel-column-card/":{"post":{"summary":"Criar card de CRM","tags":["CRM"],"description":"Cria um card numa etapa do funil de CRM para um contato existente. A etapa precisa ser do funil informado; funil, etapa, contato, responsável, campo ou etiqueta de outro escritório recusam o pedido com 404. Repetir o pedido pode criar outro card do mesmo contato na mesma etapa.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"channel":{"type":"string","description":"Canal de origem do lead (ex.: WhatsApp, web). Opcional."},"funnelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do funil de CRM onde o card será criado."},"columnId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da etapa (coluna) do funil onde o card será posicionado."},"personId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do contato vinculado ao card."},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do campo personalizado."},"name":{"type":"string","description":"Ignorado: o servidor usa só `id` e `value`."},"type":{"type":"string","description":"Ignorado: o servidor usa só `id` e `value`."},"options":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"description":"Ignorado: o servidor usa só `id` e `value`."},"value":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"description":"Valor preenchido no campo personalizado."}},"required":["id","value"],"additionalProperties":false},"description":"Campos personalizados do card preenchidos na criação."},"tags":{"type":"array","items":{"type":"string"},"description":"IDs das etiquetas do card; etiqueta de outro escritório recusa o pedido com 404. A etiqueta ativa em Conversas e CRM também entra nas conversas não privadas e nos outros cards do contato."},"userId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do usuário responsável pelo card, do mesmo escritório. Opcional."}},"required":["funnelId","columnId","personId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"showBadgeProgress":{"type":"boolean","description":"Indica se a etapa exibe indicador de progresso por tempo."},"timeLimitDays":{"type":"number","description":"Limite de dias configurado na etapa para permanência do card."},"columnChangedAt":{"type":"string","format":"date-time","description":"Data e hora em que o card foi movido para a etapa atual."},"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do card criado."},"channel":{"type":"string","nullable":true,"description":"Canal de origem do lead. Null se não informado."},"funnelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do funil ao qual o card pertence."},"columnId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da etapa atual do card."},"personId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do contato vinculado ao card."},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do campo personalizado."},"name":{"type":"string","description":"Nome do campo personalizado."},"type":{"type":"string","description":"Tipo do campo (texto, data, seleção etc.)."},"options":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"description":"Opções disponíveis para campos do tipo seleção."},"value":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"description":"Valor preenchido no campo personalizado."}},"required":["id","name","type","value"],"additionalProperties":false},"description":"Campos personalizados do card."},"tags":{"type":"array","items":{"type":"string"},"description":"Nomes das tags associadas ao card — o serviço devolve `tag.name`, não o ID."},"userId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do usuário responsável pelo card."}},"required":["showBadgeProgress","timeLimitDays","columnChangedAt","id","channel","funnelId","columnId","personId"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir cards de CRM","tags":["CRM"],"description":"Remove um ou mais cards do funil de CRM pelos IDs informados.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs dos cards a serem removidos."}},"required":["ids"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Confirmação da operação.","content":{"application/json":{"schema":{"type":"string","description":"Confirmação da operação."}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"get":{"summary":"Listar cards de CRM","tags":["CRM"],"description":"Lista os cards de uma etapa do funil de CRM com filtro por contato e paginação.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"columnId","required":true,"description":"ID da etapa do funil. Retorna os cards posicionados nessa etapa."},{"schema":{"type":"number","minimum":1},"in":"query","name":"page","required":false,"description":"Número da página (começa em 1). Enviar junto com `limit`."},{"schema":{"type":"number","minimum":1,"maximum":100},"in":"query","name":"limit","required":false,"description":"Quantidade de cards por página. Máximo: 100."},{"schema":{"type":"string"},"in":"query","name":"search","required":false,"description":"Filtra por nome ou e-mail do contato vinculado ao card."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do card."},"channel":{"type":"string","nullable":true,"description":"Canal de origem do lead. Null se não informado."},"columnId":{"type":"string","description":"ID da etapa do funil onde o card está posicionado."},"user":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do usuário responsável."},"name":{"type":"string","nullable":true,"description":"Nome do usuário. Null se não definido."},"imageUrl":{"type":"string","nullable":true,"description":"URL de avatar do usuário. Null se não definido."},"role":{"type":"string","nullable":true,"description":"Papel do usuário. Null se não definido."},"email":{"type":"string","nullable":true,"description":"E-mail do usuário. Null se não definido."},"document":{"type":"string","nullable":true,"description":"Documento do usuário. Null se não informado."}},"required":["id","name","imageUrl","role","email","document"],"additionalProperties":false,"nullable":true,"description":"Usuário responsável pelo card. Null se não atribuído."},"person":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do contato."},"name":{"type":"string","nullable":true,"description":"Nome do contato. Null se não informado."},"email":{"type":"string","nullable":true,"description":"E-mail do contato. Null se não informado."},"phone":{"type":"string","nullable":true,"description":"Telefone do contato. Null se não informado."},"imageUrl":{"type":"string","nullable":true,"description":"URL de avatar do contato. Null se não definido."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação do contato."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização do contato."}},"required":["id","name","email","phone","imageUrl","createdAt","updatedAt"],"additionalProperties":false,"description":"Contato vinculado ao card."},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do campo personalizado."},"name":{"type":"string","description":"Nome do campo personalizado."},"type":{"type":"string","description":"Tipo do campo (texto, data, seleção etc.)."},"options":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"nullable":true,"description":"Opções do campo. Null para campos sem seleção."},"value":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"description":"Valor preenchido no campo."}},"required":["id","name","type","options","value"],"additionalProperties":false},"description":"Campos personalizados do card com seus valores."},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da tag."},"name":{"type":"string","description":"Nome da tag."},"color":{"type":"string","description":"Cor da tag (ex.: código hexadecimal)."}},"required":["id","name","color"],"additionalProperties":false},"description":"Tags associadas ao card."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação do card."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização do card."}},"required":["id","channel","columnId","user","person","customFields","tags","createdAt","updatedAt"],"additionalProperties":false},"description":"Cards da página atual."},"totalResults":{"type":"number","description":"Total de registros encontrados."},"totalPages":{"type":"number","description":"Total de páginas para a quantidade solicitada."}},"required":["data","totalResults","totalPages"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/funnel-column-card/person/{personId}/conversation/{conversationId}":{"get":{"summary":"Obter card de CRM por contato e conversa","tags":["CRM"],"description":"Retorna o card de CRM vinculado ao contato na conversa informada. O funil é identificado automaticamente a partir da integração da conversa.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"personId","required":true,"description":"ID do contato."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"conversationId","required":true,"description":"ID da conversa. Usado para identificar o funil via integração."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"columnChangedAt":{"type":"string","format":"date-time","description":"Data e hora em que o card foi movido para a etapa atual."},"showBadgeProgress":{"type":"boolean","description":"Indica se a etapa exibe indicador de progresso por tempo."},"timeLimitDays":{"type":"number","description":"Limite de dias configurado na etapa para permanência do card."},"id":{"type":"string","description":"ID do card."},"channel":{"type":"string","nullable":true,"description":"Canal de origem do lead. Null se não informado."},"columnId":{"type":"string","description":"ID da etapa atual do card."},"funnelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do funil ao qual o card pertence."},"conversationId":{"type":"string","nullable":true,"description":"ID da conversa mais recente do contato na inbox dele. Null se não houver."},"conversations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da conversa neste dispositivo."},"integration":{"type":"object","properties":{"id":{"type":"string","description":"ID da integração."},"name":{"type":"string","description":"Nome do dispositivo de atendimento."},"channel":{"type":"string","enum":["WHATSAPP","WEB_CHAT","TELEGRAM","INSTAGRAM","LITE_WHATSAPP","JURIDIQ"],"description":"Canal da integração."}},"required":["id","name","channel"],"additionalProperties":false,"description":"Dispositivo em que a conversa aconteceu."}},"required":["id","integration"],"additionalProperties":false},"description":"Conversas do contato na inbox dele, da mais recente para a mais antiga. Uma por dispositivo."},"leadOrigin":{"type":"object","properties":{"source":{"type":"string","description":"Aplicativo de origem da atribuição."},"campaignName":{"type":"string","nullable":true,"description":"Título da campanha ou anúncio informado pelo provedor."},"adContent":{"type":"string","nullable":true,"description":"Texto do anúncio informado pelo provedor."},"thumbnailUrl":{"type":"string","nullable":true,"description":"URL da miniatura do anúncio."},"adUrl":{"type":"string","nullable":true,"description":"URL de destino do anúncio."},"conversionMessage":{"type":"string","description":"Mensagem inbound que iniciou a conversa atribuída."},"messageAt":{"type":"string","format":"date-time","description":"Data e hora da mensagem atribuída."}},"required":["source","campaignName","adContent","thumbnailUrl","adUrl","conversionMessage","messageAt"],"additionalProperties":false,"nullable":true,"description":"Origem atribuída do lead. Null quando não veio de anúncio."},"user":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","nullable":true,"description":"ID do usuário responsável."},"name":{"type":"string","nullable":true,"description":"Nome do usuário. Null se não definido."},"imageUrl":{"type":"string","nullable":true,"description":"URL de avatar do usuário. Null se não definido."},"role":{"type":"string","nullable":true,"description":"Papel do usuário. Null se não definido."},"email":{"type":"string","nullable":true,"description":"E-mail do usuário. Null se não definido."},"document":{"type":"string","nullable":true,"description":"Documento do usuário. Null se não informado."}},"required":["id","name","imageUrl","role","email","document"],"additionalProperties":false,"nullable":true,"description":"Usuário responsável pelo card. Null se não atribuído."},"person":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do contato."},"name":{"type":"string","nullable":true,"description":"Nome do contato. Null se não informado."},"email":{"type":"string","nullable":true,"description":"E-mail do contato. Null se não informado."},"phone":{"type":"string","nullable":true,"description":"Telefone do contato. Null se não informado."},"imageUrl":{"type":"string","nullable":true,"description":"URL de avatar do contato. Null se não definido."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação do contato."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização do contato."}},"required":["id","name","email","phone","imageUrl","createdAt","updatedAt"],"additionalProperties":false,"description":"Contato vinculado ao card."},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do campo personalizado."},"name":{"type":"string","description":"Nome do campo personalizado."},"type":{"type":"string","description":"Tipo do campo (texto, data, seleção etc.)."},"options":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"nullable":true,"description":"Opções do campo. Null para campos sem seleção."},"value":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"description":"Valor preenchido no campo."}},"required":["id","name","type","options","value"],"additionalProperties":false},"description":"Campos personalizados do card com seus valores."},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da tag."},"name":{"type":"string","description":"Nome da tag."},"color":{"type":"string","description":"Cor da tag (ex.: código hexadecimal)."}},"required":["id","name","color"],"additionalProperties":false},"description":"Tags associadas ao card."},"legalArea":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false,"nullable":true,"description":"Área jurídica vinculada à conversa do card. Null se não atribuída."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação do card."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização do card."}},"required":["columnChangedAt","showBadgeProgress","timeLimitDays","id","channel","columnId","funnelId","conversationId","conversations","leadOrigin","user","person","customFields","tags","legalArea","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/funnel-column-card/{id}":{"get":{"summary":"Obter card de CRM","tags":["CRM"],"description":"Retorna os dados completos de um card pelo ID, incluindo contato, responsável, campos personalizados e tags.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do card de CRM."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"columnChangedAt":{"type":"string","format":"date-time","description":"Data e hora em que o card foi movido para a etapa atual."},"showBadgeProgress":{"type":"boolean","description":"Indica se a etapa exibe indicador de progresso por tempo."},"timeLimitDays":{"type":"number","description":"Limite de dias configurado na etapa para permanência do card."},"id":{"type":"string","description":"ID do card."},"channel":{"type":"string","nullable":true,"description":"Canal de origem do lead. Null se não informado."},"columnId":{"type":"string","description":"ID da etapa atual do card."},"funnelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do funil ao qual o card pertence."},"conversationId":{"type":"string","nullable":true,"description":"ID da conversa mais recente do contato na inbox dele. Null se não houver."},"conversations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da conversa neste dispositivo."},"integration":{"type":"object","properties":{"id":{"type":"string","description":"ID da integração."},"name":{"type":"string","description":"Nome do dispositivo de atendimento."},"channel":{"type":"string","enum":["WHATSAPP","WEB_CHAT","TELEGRAM","INSTAGRAM","LITE_WHATSAPP","JURIDIQ"],"description":"Canal da integração."}},"required":["id","name","channel"],"additionalProperties":false,"description":"Dispositivo em que a conversa aconteceu."}},"required":["id","integration"],"additionalProperties":false},"description":"Conversas do contato na inbox dele, da mais recente para a mais antiga. Uma por dispositivo."},"leadOrigin":{"type":"object","properties":{"source":{"type":"string","description":"Aplicativo de origem da atribuição."},"campaignName":{"type":"string","nullable":true,"description":"Título da campanha ou anúncio informado pelo provedor."},"adContent":{"type":"string","nullable":true,"description":"Texto do anúncio informado pelo provedor."},"thumbnailUrl":{"type":"string","nullable":true,"description":"URL da miniatura do anúncio."},"adUrl":{"type":"string","nullable":true,"description":"URL de destino do anúncio."},"conversionMessage":{"type":"string","description":"Mensagem inbound que iniciou a conversa atribuída."},"messageAt":{"type":"string","format":"date-time","description":"Data e hora da mensagem atribuída."}},"required":["source","campaignName","adContent","thumbnailUrl","adUrl","conversionMessage","messageAt"],"additionalProperties":false,"nullable":true,"description":"Origem atribuída do lead. Null quando não veio de anúncio."},"user":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","nullable":true,"description":"ID do usuário responsável."},"name":{"type":"string","nullable":true,"description":"Nome do usuário. Null se não definido."},"imageUrl":{"type":"string","nullable":true,"description":"URL de avatar do usuário. Null se não definido."},"role":{"type":"string","nullable":true,"description":"Papel do usuário. Null se não definido."},"email":{"type":"string","nullable":true,"description":"E-mail do usuário. Null se não definido."},"document":{"type":"string","nullable":true,"description":"Documento do usuário. Null se não informado."}},"required":["id","name","imageUrl","role","email","document"],"additionalProperties":false,"nullable":true,"description":"Usuário responsável pelo card. Null se não atribuído."},"person":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do contato."},"name":{"type":"string","nullable":true,"description":"Nome do contato. Null se não informado."},"email":{"type":"string","nullable":true,"description":"E-mail do contato. Null se não informado."},"phone":{"type":"string","nullable":true,"description":"Telefone do contato. Null se não informado."},"imageUrl":{"type":"string","nullable":true,"description":"URL de avatar do contato. Null se não definido."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação do contato."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização do contato."}},"required":["id","name","email","phone","imageUrl","createdAt","updatedAt"],"additionalProperties":false,"description":"Contato vinculado ao card."},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do campo personalizado."},"name":{"type":"string","description":"Nome do campo personalizado."},"type":{"type":"string","description":"Tipo do campo (texto, data, seleção etc.)."},"options":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"nullable":true,"description":"Opções do campo. Null para campos sem seleção."},"value":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"description":"Valor preenchido no campo."}},"required":["id","name","type","options","value"],"additionalProperties":false},"description":"Campos personalizados do card com seus valores."},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da tag."},"name":{"type":"string","description":"Nome da tag."},"color":{"type":"string","description":"Cor da tag (ex.: código hexadecimal)."}},"required":["id","name","color"],"additionalProperties":false},"description":"Tags associadas ao card."},"legalArea":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false,"nullable":true,"description":"Área jurídica vinculada à conversa do card. Null se não atribuída."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação do card."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização do card."}},"required":["columnChangedAt","showBadgeProgress","timeLimitDays","id","channel","columnId","funnelId","conversationId","conversations","leadOrigin","user","person","customFields","tags","legalArea","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Atualizar card de CRM","tags":["CRM"],"description":"Atualização parcial do card: só os campos enviados mudam. `tags` e `customFields` substituem o conjunto inteiro, `legalAreaId` vai para as conversas do contato e `columnId` move o card para outra etapa do funil. Etapa, responsável, contato, campo, área ou etiqueta de outro escritório recusam o pedido com 404.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"channel":{"type":"string","description":"Novo canal de origem do lead. Opcional."},"columnId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da nova etapa do funil, do mesmo escritório. Move o card para outra etapa quando enviado."},"userId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","nullable":true,"description":"ID do novo usuário responsável pelo card, do mesmo escritório. Envie `null` para tirar o responsável. Opcional."},"personId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do novo contato vinculado ao card, do mesmo escritório. As etiquetas ativas em Conversas e CRM do card vão também para as conversas não privadas e para os outros cards do contato novo. Opcional."},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do campo personalizado."},"name":{"type":"string","description":"Ignorado: o servidor usa só `id` e `value`."},"type":{"type":"string","description":"Ignorado: o servidor usa só `id` e `value`."},"options":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"description":"Ignorado: o servidor usa só `id` e `value`."},"value":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"description":"Novo valor do campo personalizado."}},"required":["id","value"],"additionalProperties":false},"description":"Campos personalizados do card. Quando enviado, substitui todos: o campo que não vier fica sem valor."},"tags":{"type":"array","items":{"type":"string"},"description":"IDs das etiquetas. Substitui todas as etiquetas do card quando enviado; etiqueta de outro escritório recusa o pedido com 404. A etiqueta ativa em Conversas e CRM que entra ou sai também entra ou sai das conversas não privadas e dos outros cards do contato."},"legalAreaId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","nullable":true,"description":"ID da área jurídica (global ou do escritório) gravada em todas as conversas do contato na inbox do funil. Envie `null` para desvincular."},"createdAt":{"type":"string","format":"date-time","description":"Não editável: as datas do card não mudam por aqui, e o corpo JSON não carrega `Date` — enviar o campo recusa o pedido com 400."},"updatedAt":{"type":"string","format":"date-time","description":"Não editável: as datas do card não mudam por aqui, e o corpo JSON não carrega `Date` — enviar o campo recusa o pedido com 400."},"targetCardId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do card usado como referência para posicionamento."},"placement":{"type":"string","enum":["before","after","top"],"description":"Posição do card em relação ao card de referência."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do card de CRM."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"columnChangedAt":{"type":"string","format":"date-time","description":"Data e hora em que o card foi movido para a etapa atual."},"id":{"type":"string","description":"ID do card."},"channel":{"type":"string","nullable":true,"description":"Canal de origem do lead. Null se não informado."},"columnId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da etapa atual do card."},"userId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do usuário responsável pelo card."},"personId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do contato vinculado ao card."},"customFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do campo personalizado."},"value":{"anyOf":[{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}},{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}},{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}],"nullable":true}}],"description":"Valor atual do campo personalizado."}},"required":["id","value"],"additionalProperties":false},"description":"Campos personalizados do card com valores atualizados."},"tags":{"type":"array","items":{"type":"string"},"description":"Nomes das tags associadas ao card — o serviço devolve `tag.name`, não o ID."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação do card."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização do card."}},"required":["columnChangedAt","id","channel","columnId","personId","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/funnel-column-card/{id}/history":{"get":{"summary":"Histórico de etapas do card","tags":["CRM"],"description":"Retorna as etapas por onde o card passou, com data de entrada/saída e tempo (ms) em cada uma.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do card de CRM."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fromColumn":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true,"description":"Etapa anterior. Null quando é a primeira etapa do card."},"toColumn":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"enteredAt":{"type":"string","format":"date-time"},"exitedAt":{"type":"string","format":"date-time","nullable":true,"description":"Null enquanto o card ainda está nesta etapa."},"isCurrent":{"type":"boolean","description":"true = etapa atual do card (exitedAt null)."},"durationMs":{"type":"number","description":"Tempo nesta etapa em ms. Se isCurrent, calculado até agora."},"source":{"type":"string","enum":["USER","SYSTEM","FLOW","AGENT","AUTOMATION"]},"changedByUser":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true}},"required":["id","fromColumn","toColumn","enteredAt","exitedAt","isCurrent","durationMs","source","changedByUser"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/funnel-column-card/migrate":{"post":{"summary":"Mover cards em lote","tags":["CRM"],"description":"Move cards entre etapas do funil de CRM. Envie `cardIds` para mover cards específicos, ou `sourceColumnId` para mover todos os cards de uma etapa. Não é possível usar os dois ao mesmo tempo.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"cardIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs dos cards a serem movidos. Usar quando quiser mover cards específicos."},"sourceColumnId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da etapa de origem. Quando informado, move todos os cards dessa etapa. Não usar junto com `cardIds`."},"targetColumnId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da etapa de destino para onde os cards serão movidos."}},"required":["targetColumnId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"migratedCount":{"type":"number","description":"Quantidade de cards movidos com sucesso."},"skippedCount":{"type":"number","description":"Quantidade de cards que não foram movidos por falta de campos obrigatórios."},"skipped":{"type":"array","items":{"type":"object","properties":{"cardId":{"type":"string","description":"ID do card que não foi movido."},"personName":{"type":"string","nullable":true,"description":"Nome do contato dono do card."},"missingFields":{"type":"array","items":{"type":"string"},"description":"Nomes dos campos obrigatórios que faltam preencher."}},"required":["cardId","personName","missingFields"],"additionalProperties":false},"description":"Cards bloqueados por campos obrigatórios não preenchidos."},"sourceColumnId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da etapa de origem. Presente apenas quando `sourceColumnId` foi informado."},"targetColumnId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da etapa de destino."},"targetFunnelId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID do funil ao qual a etapa de destino pertence."}},"required":["migratedCount","skippedCount","skipped","targetColumnId","targetFunnelId"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/flow/":{"post":{"summary":"Criar fluxo","tags":["Flow"],"description":"Cria um novo fluxo.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Nome do fluxo."},"description":{"type":"string","description":"Descrição do fluxo."},"content":{"type":"object","properties":{"steps":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["text"]}},"required":["id","content","type"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["list"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","options"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["system"]},"systemAction":{"type":"string","enum":["SEARCH_MOVEMENTS","ASSIGN_USER","ADD_LABELS","ADD_CRM_LABELS","CHANGE_CRM_COLUMN","ASSIGN_AGENT","CREATE_TICKET","FIRE_WEBHOOK","CHECK_INSTAGRAM_FOLLOWER"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","systemAction"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["input"]},"validation":{"type":"object","properties":{"type":{"type":"string","enum":["cnj","email","phone","text"]},"errorMessage":{"type":"string"}},"required":["type"],"additionalProperties":false}},"required":["id","content","type"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["button"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","options"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["media"]},"mediaType":{"type":"string","enum":["audio","image","video","document"]},"url":{"type":"string"},"fileName":{"type":"string"}},"required":["id","content","type","mediaType","url"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["template"]},"templateName":{"type":"string","minLength":1},"variables":{"type":"array","items":{"type":"string"}},"headerVariables":{"type":"array","items":{"type":"string"}}},"required":["id","content","type","templateName"],"additionalProperties":false}]}},"initialStepId":{"type":"string","nullable":true},"inactivity":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Liga a pausa por ausência de resposta."},"minutes":{"type":"integer","minimum":1,"maximum":10080,"description":"Minutos sem mensagem na conversa até a ação."},"action":{"type":"string","enum":["TRANSFER","END"],"description":"TRANSFER leva ao setor, ao atendente ou à fila geral; END encerra."},"departmentId":{"type":"string","nullable":true,"description":"Setor que recebe a conversa no TRANSFER."},"userId":{"type":"string","nullable":true,"description":"Atendente que recebe a conversa no TRANSFER."}},"required":["enabled","minutes","action"],"additionalProperties":false}},"required":["steps"],"additionalProperties":false,"description":"Diagrama JSON do fluxo (nós e conexões)."},"color":{"type":"string","nullable":true,"description":"Cor do fluxo. Null se não definida."},"inboxId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da inbox vinculada ao fluxo."},"isInstagramFlow":{"type":"boolean","default":false,"description":"Indica se o fluxo é exclusivo do Instagram."}},"required":["name","description","content","color","inboxId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"content":{"type":"object","properties":{"steps":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["text"]}},"required":["id","content","type"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["list"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","options"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["system"]},"systemAction":{"type":"string","enum":["SEARCH_MOVEMENTS","ASSIGN_USER","ADD_LABELS","ADD_CRM_LABELS","CHANGE_CRM_COLUMN","ASSIGN_AGENT","CREATE_TICKET","FIRE_WEBHOOK","CHECK_INSTAGRAM_FOLLOWER"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","systemAction"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["input"]},"validation":{"type":"object","properties":{"type":{"type":"string","enum":["cnj","email","phone","text"]},"errorMessage":{"type":"string"}},"required":["type"],"additionalProperties":false}},"required":["id","content","type"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["button"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","options"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["media"]},"mediaType":{"type":"string","enum":["audio","image","video","document"]},"url":{"type":"string"},"fileName":{"type":"string"}},"required":["id","content","type","mediaType","url"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["template"]},"templateName":{"type":"string","minLength":1},"variables":{"type":"array","items":{"type":"string"}},"headerVariables":{"type":"array","items":{"type":"string"}}},"required":["id","content","type","templateName"],"additionalProperties":false}]}},"initialStepId":{"type":"string","nullable":true},"inactivity":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Liga a pausa por ausência de resposta."},"minutes":{"type":"integer","minimum":1,"maximum":10080,"description":"Minutos sem mensagem na conversa até a ação."},"action":{"type":"string","enum":["TRANSFER","END"],"description":"TRANSFER leva ao setor, ao atendente ou à fila geral; END encerra."},"departmentId":{"type":"string","nullable":true,"description":"Setor que recebe a conversa no TRANSFER."},"userId":{"type":"string","nullable":true,"description":"Atendente que recebe a conversa no TRANSFER."}},"required":["enabled","minutes","action"],"additionalProperties":false}},"required":["steps"],"additionalProperties":false},"color":{"type":"string","nullable":true},"isInstagramFlow":{"type":"boolean"},"inboxId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"}},"required":["id","name","content","color","isInstagramFlow","inboxId"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"get":{"summary":"Listar fluxos","tags":["Flow"],"description":"Lista os fluxos de uma inbox.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox."},{"schema":{"type":"number","minimum":1},"in":"query","name":"page","required":false,"description":"Número da página."},{"schema":{"type":"number","minimum":1,"maximum":100},"in":"query","name":"limit","required":false,"description":"Quantidade de itens por página. O padrão é 100."},{"schema":{"type":"boolean"},"in":"query","name":"isInstagramFlow","required":false,"description":"Quando true, lista apenas fluxos do Instagram."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"content":{"type":"object","properties":{"steps":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["text"]}},"required":["id","content","type"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["list"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","options"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["system"]},"systemAction":{"type":"string","enum":["SEARCH_MOVEMENTS","ASSIGN_USER","ADD_LABELS","ADD_CRM_LABELS","CHANGE_CRM_COLUMN","ASSIGN_AGENT","CREATE_TICKET","FIRE_WEBHOOK","CHECK_INSTAGRAM_FOLLOWER"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","systemAction"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["input"]},"validation":{"type":"object","properties":{"type":{"type":"string","enum":["cnj","email","phone","text"]},"errorMessage":{"type":"string"}},"required":["type"],"additionalProperties":false}},"required":["id","content","type"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["button"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","options"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["media"]},"mediaType":{"type":"string","enum":["audio","image","video","document"]},"url":{"type":"string"},"fileName":{"type":"string"}},"required":["id","content","type","mediaType","url"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["template"]},"templateName":{"type":"string","minLength":1},"variables":{"type":"array","items":{"type":"string"}},"headerVariables":{"type":"array","items":{"type":"string"}}},"required":["id","content","type","templateName"],"additionalProperties":false}]}},"initialStepId":{"type":"string","nullable":true},"inactivity":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Liga a pausa por ausência de resposta."},"minutes":{"type":"integer","minimum":1,"maximum":10080,"description":"Minutos sem mensagem na conversa até a ação."},"action":{"type":"string","enum":["TRANSFER","END"],"description":"TRANSFER leva ao setor, ao atendente ou à fila geral; END encerra."},"departmentId":{"type":"string","nullable":true,"description":"Setor que recebe a conversa no TRANSFER."},"userId":{"type":"string","nullable":true,"description":"Atendente que recebe a conversa no TRANSFER."}},"required":["enabled","minutes","action"],"additionalProperties":false}},"required":["steps"],"additionalProperties":false},"color":{"type":"string","nullable":true},"isInstagramFlow":{"type":"boolean"},"inboxId":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","description","content","color","isInstagramFlow","inboxId","createdAt","updatedAt"],"additionalProperties":false}},"totalResults":{"type":"number"},"totalPages":{"type":"number"}},"required":["data","totalResults","totalPages"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/flow/{id}":{"get":{"summary":"Obter fluxo","tags":["Flow"],"description":"Retorna um fluxo pelo ID.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do fluxo."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"content":{"type":"object","properties":{"steps":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["text"]}},"required":["id","content","type"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["list"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","options"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["system"]},"systemAction":{"type":"string","enum":["SEARCH_MOVEMENTS","ASSIGN_USER","ADD_LABELS","ADD_CRM_LABELS","CHANGE_CRM_COLUMN","ASSIGN_AGENT","CREATE_TICKET","FIRE_WEBHOOK","CHECK_INSTAGRAM_FOLLOWER"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","systemAction"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["input"]},"validation":{"type":"object","properties":{"type":{"type":"string","enum":["cnj","email","phone","text"]},"errorMessage":{"type":"string"}},"required":["type"],"additionalProperties":false}},"required":["id","content","type"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["button"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","options"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["media"]},"mediaType":{"type":"string","enum":["audio","image","video","document"]},"url":{"type":"string"},"fileName":{"type":"string"}},"required":["id","content","type","mediaType","url"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["template"]},"templateName":{"type":"string","minLength":1},"variables":{"type":"array","items":{"type":"string"}},"headerVariables":{"type":"array","items":{"type":"string"}}},"required":["id","content","type","templateName"],"additionalProperties":false}]}},"initialStepId":{"type":"string","nullable":true},"inactivity":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Liga a pausa por ausência de resposta."},"minutes":{"type":"integer","minimum":1,"maximum":10080,"description":"Minutos sem mensagem na conversa até a ação."},"action":{"type":"string","enum":["TRANSFER","END"],"description":"TRANSFER leva ao setor, ao atendente ou à fila geral; END encerra."},"departmentId":{"type":"string","nullable":true,"description":"Setor que recebe a conversa no TRANSFER."},"userId":{"type":"string","nullable":true,"description":"Atendente que recebe a conversa no TRANSFER."}},"required":["enabled","minutes","action"],"additionalProperties":false}},"required":["steps"],"additionalProperties":false},"color":{"type":"string","nullable":true},"isInstagramFlow":{"type":"boolean"},"inboxId":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"integrations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}}},"required":["id","name","description","content","color","isInstagramFlow","inboxId","createdAt","updatedAt","integrations"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Atualizar fluxo","tags":["Flow"],"description":"Atualiza um fluxo existente.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Nome do fluxo."},"description":{"type":"string","description":"Descrição do fluxo."},"content":{"type":"object","properties":{"steps":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["text"]}},"required":["id","content","type"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["list"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","options"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["system"]},"systemAction":{"type":"string","enum":["SEARCH_MOVEMENTS","ASSIGN_USER","ADD_LABELS","ADD_CRM_LABELS","CHANGE_CRM_COLUMN","ASSIGN_AGENT","CREATE_TICKET","FIRE_WEBHOOK","CHECK_INSTAGRAM_FOLLOWER"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","systemAction"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["input"]},"validation":{"type":"object","properties":{"type":{"type":"string","enum":["cnj","email","phone","text"]},"errorMessage":{"type":"string"}},"required":["type"],"additionalProperties":false}},"required":["id","content","type"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["button"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","options"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["media"]},"mediaType":{"type":"string","enum":["audio","image","video","document"]},"url":{"type":"string"},"fileName":{"type":"string"}},"required":["id","content","type","mediaType","url"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["template"]},"templateName":{"type":"string","minLength":1},"variables":{"type":"array","items":{"type":"string"}},"headerVariables":{"type":"array","items":{"type":"string"}}},"required":["id","content","type","templateName"],"additionalProperties":false}]}},"initialStepId":{"type":"string","nullable":true},"inactivity":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Liga a pausa por ausência de resposta."},"minutes":{"type":"integer","minimum":1,"maximum":10080,"description":"Minutos sem mensagem na conversa até a ação."},"action":{"type":"string","enum":["TRANSFER","END"],"description":"TRANSFER leva ao setor, ao atendente ou à fila geral; END encerra."},"departmentId":{"type":"string","nullable":true,"description":"Setor que recebe a conversa no TRANSFER."},"userId":{"type":"string","nullable":true,"description":"Atendente que recebe a conversa no TRANSFER."}},"required":["enabled","minutes","action"],"additionalProperties":false}},"required":["steps"],"additionalProperties":false,"description":"Diagrama JSON do fluxo (nós e conexões). Sem `inactivity`, mantém a pausa por inatividade salva."},"color":{"type":"string","description":"Cor do fluxo."},"inactivity":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Liga a pausa por ausência de resposta."},"minutes":{"type":"integer","minimum":1,"maximum":10080,"description":"Minutos sem mensagem na conversa até a ação."},"action":{"type":"string","enum":["TRANSFER","END"],"description":"TRANSFER leva ao setor, ao atendente ou à fila geral; END encerra."},"departmentId":{"type":"string","nullable":true,"description":"Setor que recebe a conversa no TRANSFER."},"userId":{"type":"string","nullable":true,"description":"Atendente que recebe a conversa no TRANSFER."}},"required":["enabled","minutes","action"],"additionalProperties":false,"description":"Pausa por ausência de resposta. Grava sem reenviar os passos; vence `content.inactivity`."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do fluxo."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"content":{"type":"object","properties":{"steps":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["text"]}},"required":["id","content","type"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["list"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","options"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["system"]},"systemAction":{"type":"string","enum":["SEARCH_MOVEMENTS","ASSIGN_USER","ADD_LABELS","ADD_CRM_LABELS","CHANGE_CRM_COLUMN","ASSIGN_AGENT","CREATE_TICKET","FIRE_WEBHOOK","CHECK_INSTAGRAM_FOLLOWER"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","systemAction"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["input"]},"validation":{"type":"object","properties":{"type":{"type":"string","enum":["cnj","email","phone","text"]},"errorMessage":{"type":"string"}},"required":["type"],"additionalProperties":false}},"required":["id","content","type"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["button"]},"options":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"title":{"type":"string"},"value":{"type":"string"},"nextStepId":{"type":"string","nullable":true}},"required":["text","title","value","nextStepId"],"additionalProperties":false}}},"required":["id","content","type","options"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["media"]},"mediaType":{"type":"string","enum":["audio","image","video","document"]},"url":{"type":"string"},"fileName":{"type":"string"}},"required":["id","content","type","mediaType","url"],"additionalProperties":false},{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"internalType":{"type":"string"},"nextStepId":{"type":"string","nullable":true},"position":{"type":"object","properties":{"x":{"type":"number"},"y":{"type":"number"}},"required":["x","y"],"additionalProperties":false,"nullable":true},"metadata":{"type":"object","properties":{"userId":{"type":"string","nullable":true},"departmentId":{"type":"string","nullable":true},"departmentIds":{"type":"array","items":{"type":"string"},"maxItems":5,"nullable":true},"agentId":{"type":"string","nullable":true},"isAvailable":{"type":"boolean","nullable":true},"distributeByChannel":{"type":"boolean","nullable":true},"tagIds":{"type":"array","items":{"type":"string"},"nullable":true},"funnelId":{"type":"string","nullable":true},"funnelColumnId":{"type":"string","nullable":true},"ticketTitle":{"type":"string","nullable":true},"ticketDescription":{"type":"string","nullable":true},"ticketStatusId":{"type":"string","nullable":true},"ticketPriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"nullable":true},"ticketAssigneeIds":{"type":"array","items":{"type":"string"},"nullable":true},"ticketDepartmentIds":{"type":"array","items":{"type":"string"},"nullable":true},"assigneeDistribution":{"type":"string","enum":["NONE","SPECIFIC","RANDOM","ROUND_ROBIN","LOAD"],"nullable":true},"rotationUserIds":{"type":"array","items":{"type":"string"},"nullable":true},"ignoreSchedules":{"type":"array","items":{"type":"object","properties":{"userIds":{"type":"array","items":{"type":"string"}},"startTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"endTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6}}},"required":["userIds","startTime","endTime"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookUrl":{"type":"string","nullable":true},"webhookMethod":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"nullable":true},"webhookHeaders":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}},"required":["key","value"],"additionalProperties":false},"maxItems":20,"nullable":true},"webhookBody":{"type":"string","nullable":true},"webhookIncludeContext":{"type":"boolean","nullable":true}},"additionalProperties":false},"type":{"type":"string","enum":["template"]},"templateName":{"type":"string","minLength":1},"variables":{"type":"array","items":{"type":"string"}},"headerVariables":{"type":"array","items":{"type":"string"}}},"required":["id","content","type","templateName"],"additionalProperties":false}]}},"initialStepId":{"type":"string","nullable":true},"inactivity":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Liga a pausa por ausência de resposta."},"minutes":{"type":"integer","minimum":1,"maximum":10080,"description":"Minutos sem mensagem na conversa até a ação."},"action":{"type":"string","enum":["TRANSFER","END"],"description":"TRANSFER leva ao setor, ao atendente ou à fila geral; END encerra."},"departmentId":{"type":"string","nullable":true,"description":"Setor que recebe a conversa no TRANSFER."},"userId":{"type":"string","nullable":true,"description":"Atendente que recebe a conversa no TRANSFER."}},"required":["enabled","minutes","action"],"additionalProperties":false}},"required":["steps"],"additionalProperties":false},"color":{"type":"string","nullable":true},"isInstagramFlow":{"type":"boolean"},"inboxId":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","description","content","color","isInstagramFlow","inboxId","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir fluxo","tags":["Flow"],"description":"Remove um fluxo existente.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do fluxo."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/flow/{flowId}/medias":{"get":{"summary":"Listar mídias do fluxo","tags":["Flow"],"description":"Retorna os arquivos de áudio e documento enviados para o fluxo.","parameters":[{"schema":{"type":"string"},"in":"path","name":"flowId","required":true,"description":"ID do fluxo."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"flowId":{"type":"string"},"url":{"type":"string"},"mediaType":{"type":"string","enum":["audio","image","video","document"]},"fileName":{"type":"string"}},"required":["flowId","url","mediaType","fileName"],"additionalProperties":false}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/scheduled-message/":{"get":{"summary":"Listar mensagens agendadas","tags":["ScheduledMessages"],"description":"Lista mensagens agendadas com filtros por conversa, inbox e status. `page` padrão 1, `limit` padrão 20. `counters` totaliza por status sobre todos os registros visíveis — não muda com a página nem com o filtro `status`.","parameters":[{"schema":{"anyOf":[{"type":"string"},{"type":"number"}],"default":1},"in":"query","name":"page","required":false,"description":"Número da página."},{"schema":{"anyOf":[{"type":"string"},{"type":"number"}],"default":20},"in":"query","name":"limit","required":false,"description":"Quantidade de itens por página."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"conversationId","required":false,"description":"Filtra pelo ID da conversa."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"inboxId","required":false,"description":"Filtra pelo ID da inbox."},{"schema":{"type":"string","enum":["PENDING","PROCESSING","SENT","CANCELLED"]},"in":"query","name":"status","required":false,"description":"Filtra pelo status do agendamento."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do agendamento."},"conversationId":{"type":"string","description":"ID da conversa vinculada."},"userId":{"type":"string","nullable":true,"description":"ID do usuário que criou o agendamento (null quando criado por automação)."},"content":{"description":"Conteúdo da mensagem agendada."},"type":{"type":"string","description":"Tipo da mensagem (texto, imagem, etc.)."},"metadata":{"nullable":true,"description":"Dados adicionais da mensagem. Null se não houver."},"scheduledAt":{"type":"string","format":"date-time","description":"Data e hora programada para o envio."},"status":{"type":"string","enum":["PENDING","PROCESSING","SENT","CANCELLED"],"description":"Status do agendamento."},"sentAt":{"type":"string","format":"date-time","nullable":true,"description":"Data e hora do envio efetivo. Null se ainda não enviado."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."},"conversation":{"type":"object","properties":{"id":{"type":"string","description":"ID da conversa."},"person":{"type":"object","properties":{"id":{"type":"string","description":"ID do contato."},"name":{"type":"string","nullable":true,"description":"Nome do contato. Null se não informado."},"phoneNumber":{"type":"string","nullable":true,"description":"Número de telefone do contato."}},"required":["id","name","phoneNumber"],"additionalProperties":false,"nullable":true,"description":"Contato da conversa individual. Null para grupos."},"group":{"type":"object","properties":{"id":{"type":"string","description":"ID do grupo."},"name":{"type":"string","description":"Nome do grupo."}},"required":["id","name"],"additionalProperties":false,"nullable":true,"description":"Dados do grupo. Null para conversas individuais."},"integration":{"type":"object","properties":{"id":{"type":"string","description":"ID da integração."},"channel":{"type":"string","description":"Canal da integração (WHATSAPP, LITE_WHATSAPP, etc.)."}},"required":["id","channel"],"additionalProperties":false,"description":"Integração vinculada à conversa."}},"required":["id","person","group"],"additionalProperties":false}},"required":["id","conversationId","userId","type","scheduledAt","status","sentAt","createdAt","updatedAt","conversation"],"additionalProperties":false},"description":"Itens da página atual."},"totalResults":{"type":"number","description":"Total de registros encontrados."},"totalPages":{"type":"number","description":"Total de páginas para a quantidade solicitada."},"counters":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"description":"Total de agendamentos que atendem aos filtros."},"pending":{"type":"integer","minimum":0,"description":"Agendamentos com status PENDING."},"processing":{"type":"integer","minimum":0,"description":"Agendamentos com status PROCESSING."},"sent":{"type":"integer","minimum":0,"description":"Agendamentos com status SENT."},"cancelled":{"type":"integer","minimum":0,"description":"Agendamentos com status CANCELLED."}},"required":["total","pending","processing","sent","cancelled"],"additionalProperties":false,"description":"Totalizadores por status sobre todos os registros visíveis, independentes de paginação e do filtro `status`."}},"required":["data","totalResults","totalPages","counters"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Agendar mensagem","tags":["ScheduledMessages"],"description":"Agenda uma mensagem para envio futuro. O body deve ser enviado como `multipart/form-data`. Em integrações WhatsApp Oficial, use `type: template` com `templateName` e variáveis.","requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"conversationId":{"description":"ID da conversa. Enviado como campo de formulário (`multipart/form-data`)."},"message":{"description":"Texto da mensagem. Obrigatório quando `type` for `text`."},"type":{"description":"Tipo da mensagem: `text`, `audio`, `image`, `video`, `document`, `contact` ou `template`."},"file":{"description":"Arquivo de mídia. Obrigatório para tipos de mídia."},"caption":{"description":"Legenda da mídia. Opcional."},"fileName":{"description":"Nome do arquivo para documentos. Opcional."},"contactName":{"description":"Nome do contato. Obrigatório quando `type` for `contact`."},"contactPhoneNumber":{"description":"Telefone do contato. Obrigatório quando `type` for `contact`."},"scheduledAt":{"description":"Data e hora de envio no formato ISO 8601."},"templateName":{"description":"Nome do template WhatsApp. Obrigatório quando `type` for `template`."},"variables":{"description":"Variáveis do corpo do template em JSON array ou lista separada por vírgula."},"headerVariables":{"description":"Variáveis do cabeçalho do template em JSON array ou lista separada por vírgula."},"headerVariableNames":{"description":"Nomes das variáveis do cabeçalho em JSON array."},"bodyVariableNames":{"description":"Nomes das variáveis do corpo em JSON array."},"buttonVariables":{"description":"Variáveis de botões dinâmicos do template em JSON array."},"headerMedia":{"description":"Mídia do cabeçalho do template em JSON."}},"additionalProperties":false}}}},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"ID do agendamento."},"conversationId":{"type":"string","description":"ID da conversa vinculada."},"userId":{"type":"string","nullable":true,"description":"ID do usuário que criou o agendamento (null quando criado por automação)."},"content":{"description":"Conteúdo da mensagem agendada."},"type":{"type":"string","description":"Tipo da mensagem (texto, imagem, etc.)."},"metadata":{"nullable":true,"description":"Dados adicionais da mensagem. Null se não houver."},"scheduledAt":{"type":"string","format":"date-time","description":"Data e hora programada para o envio."},"status":{"type":"string","enum":["PENDING","PROCESSING","SENT","CANCELLED"],"description":"Status do agendamento."},"sentAt":{"type":"string","format":"date-time","nullable":true,"description":"Data e hora do envio efetivo. Null se ainda não enviado."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","conversationId","userId","type","scheduledAt","status","sentAt","createdAt","updatedAt"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/scheduled-message/{scheduledMessageId}":{"patch":{"summary":"Atualizar mensagem agendada","tags":["ScheduledMessages"],"description":"Atualiza um agendamento com status pendente. Apenas os campos enviados são modificados. O body deve ser enviado como `multipart/form-data`.","requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"message":{"description":"Novo texto. Aplicável quando `type` for `text`."},"type":{"description":"Novo tipo da mensagem: `text`, `audio`, `image`, `video`, `document`, `contact` ou `template`."},"file":{"description":"Novo arquivo de mídia. Substitui o arquivo atual quando enviado."},"caption":{"description":"Nova legenda da mídia."},"fileName":{"description":"Novo nome do arquivo."},"contactName":{"description":"Novo nome do contato (tipo `contact`)."},"contactPhoneNumber":{"description":"Novo telefone do contato (tipo `contact`)."},"scheduledAt":{"description":"Nova data e hora de envio no formato ISO 8601."},"templateName":{"description":"Nome do template WhatsApp. Obrigatório quando `type` for `template`."},"variables":{"description":"Variáveis do corpo do template."},"headerVariables":{"description":"Variáveis do cabeçalho do template."},"headerVariableNames":{"description":"Nomes das variáveis do cabeçalho."},"bodyVariableNames":{"description":"Nomes das variáveis do corpo."},"buttonVariables":{"description":"Variáveis de botões dinâmicos do template."},"headerMedia":{"description":"Mídia do cabeçalho do template em JSON."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"scheduledMessageId","required":true,"description":"ID do agendamento."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"ID do agendamento."},"conversationId":{"type":"string","description":"ID da conversa vinculada."},"userId":{"type":"string","nullable":true,"description":"ID do usuário que criou o agendamento (null quando criado por automação)."},"content":{"description":"Conteúdo da mensagem agendada."},"type":{"type":"string","description":"Tipo da mensagem (texto, imagem, etc.)."},"metadata":{"nullable":true,"description":"Dados adicionais da mensagem. Null se não houver."},"scheduledAt":{"type":"string","format":"date-time","description":"Data e hora programada para o envio."},"status":{"type":"string","enum":["PENDING","PROCESSING","SENT","CANCELLED"],"description":"Status do agendamento."},"sentAt":{"type":"string","format":"date-time","nullable":true,"description":"Data e hora do envio efetivo. Null se ainda não enviado."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","conversationId","userId","type","scheduledAt","status","sentAt","createdAt","updatedAt"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir mensagem agendada","tags":["ScheduledMessages"],"description":"Remove um agendamento (tipicamente em estado `PENDING`).","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"scheduledMessageId","required":true,"description":"ID do agendamento a ser excluído."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indica se a exclusão foi concluída com sucesso."}},"required":["success"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/scheduled-message/{scheduledMessageId}/cancel":{"patch":{"summary":"Cancelar mensagem agendada","tags":["ScheduledMessages"],"description":"Cancela um agendamento pendente. O registro é mantido com status `CANCELLED`.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"scheduledMessageId","required":true,"description":"ID do agendamento a ser cancelado."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Indica se o cancelamento foi aplicado com sucesso."}},"required":["success"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/webhooks/events":{"get":{"summary":"Listar eventos disponíveis","tags":["Webhooks"],"description":"Retorna o catálogo completo de eventos disponíveis para inscrição, agrupados por domínio. Use o campo `name` de cada evento ao criar ou atualizar um webhook.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"group":{"type":"string","description":"Nome do grupo de domínio (ex.: CRM, Chat, Contato)."},"description":{"type":"string","description":"Descrição do grupo de domínio."},"events":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nome do evento no formato `domínio.recurso.ação`."},"description":{"type":"string","description":"Descrição legível de quando este evento é disparado."}},"required":["name","description"],"additionalProperties":false},"description":"Eventos disponíveis neste grupo."}},"required":["group","description","events"],"additionalProperties":false}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/webhooks/":{"post":{"summary":"Criar webhook","tags":["Webhooks"],"description":"Cria um novo endpoint de webhook. O response inclui um `secret` que você deve armazenar — ele é usado para verificar o header `X-JuriChat-Signature` em cada entrega.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100,"description":"Nome legível para este endpoint de webhook (ex.: \"Integração com CRM\")."},"description":{"type":"string","maxLength":500,"description":"Descrição opcional explicando para que este webhook é usado."},"url":{"type":"string","format":"uri","description":"A URL HTTPS que receberá os payloads de evento via HTTP POST."},"events":{"type":"array","items":{"type":"string","enum":["crm.lead.created","crm.lead.updated","crm.lead.deleted","crm.lead.moved","crm.lead.overdue","chat.conversation.created","chat.conversation.updated","chat.conversation.assigned","chat.conversation.no_reply","chat.message.received","chat.message.sent","contact.created","contact.updated","contact.deleted","instagram.direct.received","instagram.comment.received","instagram.story_mention.received","instagram.story_reply.received","instagram.ice_breaker.received","webhook.test"]},"minItems":1,"description":"Lista de nomes de eventos para se inscrever. Use `GET /webhooks/events` para listar todos os eventos disponíveis."},"isActive":{"type":"boolean","default":true,"description":"Se este webhook está ativo. Webhooks inativos não recebem nenhum evento."},"headers":{"type":"object","additionalProperties":{"type":"string"},"description":"Cabeçalhos HTTP personalizados opcionais para incluir em cada requisição de entrega (ex.: `{\"Authorization\": \"Bearer token\"}`)."}},"required":["name","url","events"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID único do webhook."},"officeId":{"type":"string","description":"ID do escritório ao qual este webhook pertence."},"name":{"type":"string","description":"Nome do webhook."},"description":{"type":"string","nullable":true,"description":"Descrição do webhook."},"url":{"type":"string","description":"URL de destino para entregas de eventos."},"secret":{"type":"string","description":"HMAC-SHA256 segredo de autenticação usado para verificar o header `X-JuriChat-Signature` em cada entrega."},"events":{"type":"array","items":{"type":"string"},"description":"Lista de nomes de eventos inscritos."},"isActive":{"type":"boolean","description":"Se este webhook está ativo."},"headers":{"type":"object","additionalProperties":{"type":"string"},"nullable":true,"description":"Cabeçalhos personalizados enviados com cada entrega."},"createdAt":{"type":"string","description":"Timestamp de criação ISO 8601."},"updatedAt":{"type":"string","description":"Timestamp de última atualização ISO 8601."}},"required":["id","officeId","name","description","url","secret","events","isActive","headers","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"get":{"summary":"Listar webhooks","tags":["Webhooks"],"description":"Retorna todos os webhooks do escritório vinculado à autenticação (JWT ou chave de API), incluindo estatísticas de entrega (total, taxa de sucesso e falhas).","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID único do webhook."},"officeId":{"type":"string","description":"ID do escritório ao qual este webhook pertence."},"name":{"type":"string","description":"Nome do webhook."},"description":{"type":"string","nullable":true,"description":"Descrição do webhook."},"url":{"type":"string","description":"URL de destino para entregas de eventos."},"events":{"type":"array","items":{"type":"string"},"description":"Lista de nomes de eventos inscritos."},"isActive":{"type":"boolean","description":"Se este webhook está ativo."},"createdAt":{"type":"string","description":"Timestamp de criação ISO 8601."},"updatedAt":{"type":"string","description":"Timestamp de última atualização ISO 8601."},"stats":{"type":"object","properties":{"totalDeliveries":{"type":"number","description":"Total de tentativas de entrega em todos os tempos."},"successCount":{"type":"number","description":"Total de entregas bem-sucedidas (HTTP 2xx)."},"failedCount":{"type":"number","description":"Total de entregas permanentemente falhadas."},"successRate":{"type":"number","description":"Taxa de sucesso como um percentual (0–100)."}},"required":["totalDeliveries","successCount","failedCount","successRate"],"additionalProperties":false,"description":"Estatísticas de entrega para este webhook."}},"required":["id","officeId","name","description","url","events","isActive","createdAt","updatedAt","stats"],"additionalProperties":false}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/webhooks/{webhookId}":{"get":{"summary":"Obter um webhook","tags":["Webhooks"],"description":"Retorna os detalhes completos de um webhook específico, incluindo seu segredo de autenticação.","parameters":[{"schema":{"type":"string"},"in":"path","name":"webhookId","required":true,"description":"ID único do webhook."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID único do webhook."},"officeId":{"type":"string","description":"ID do escritório ao qual este webhook pertence."},"name":{"type":"string","description":"Nome do webhook."},"description":{"type":"string","nullable":true,"description":"Descrição do webhook."},"url":{"type":"string","description":"URL de destino para entregas de eventos."},"secret":{"type":"string","description":"HMAC-SHA256 segredo de autenticação usado para verificar o header `X-JuriChat-Signature`."},"events":{"type":"array","items":{"type":"string"},"description":"Lista de nomes de eventos inscritos."},"isActive":{"type":"boolean","description":"Se este webhook está ativo."},"headers":{"type":"object","additionalProperties":{"type":"string"},"nullable":true,"description":"Cabeçalhos personalizados enviados com cada entrega."},"createdAt":{"type":"string","description":"Timestamp de criação ISO 8601."},"updatedAt":{"type":"string","description":"Timestamp de última atualização ISO 8601."}},"required":["id","officeId","name","description","url","secret","events","isActive","headers","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Atualizar um webhook","tags":["Webhooks"],"description":"Atualiza parcialmente um webhook. Apenas os campos fornecidos são alterados.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100,"description":"Novo nome para o webhook."},"description":{"type":"string","maxLength":500,"nullable":true,"description":"Nova descrição. Envie `null` para remover a descrição."},"url":{"type":"string","format":"uri","description":"Nova URL de destino."},"secret":{"type":"string","minLength":8,"maxLength":256,"description":"Novo segredo HMAC para assinatura de payloads. Envie para rotacionar o secret."},"events":{"type":"array","items":{"type":"string","enum":["crm.lead.created","crm.lead.updated","crm.lead.deleted","crm.lead.moved","crm.lead.overdue","chat.conversation.created","chat.conversation.updated","chat.conversation.assigned","chat.conversation.no_reply","chat.message.received","chat.message.sent","contact.created","contact.updated","contact.deleted","instagram.direct.received","instagram.comment.received","instagram.story_mention.received","instagram.story_reply.received","instagram.ice_breaker.received","webhook.test"]},"minItems":1,"description":"Nova lista de eventos inscritos. Substitui a lista existente inteiramente."},"isActive":{"type":"boolean","description":"Defina para `false` para pausar as entregas sem deletar o webhook."},"headers":{"type":"object","additionalProperties":{"type":"string"},"nullable":true,"description":"Cabeçalhos personalizados. Envie `null` para remover todos os cabeçalhos personalizados."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"webhookId","required":true,"description":"ID único do webhook a ser atualizado."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID único do webhook."},"officeId":{"type":"string","description":"ID do escritório ao qual este webhook pertence."},"name":{"type":"string","description":"Nome atualizado."},"description":{"type":"string","nullable":true,"description":"Descrição atualizada."},"url":{"type":"string","description":"URL de destino atualizada."},"events":{"type":"array","items":{"type":"string"},"description":"Lista de eventos inscritos atualizada."},"isActive":{"type":"boolean","description":"Status ativo atualizado."},"headers":{"type":"object","additionalProperties":{"type":"string"},"nullable":true,"description":"Cabeçalhos personalizados atualizados."},"createdAt":{"type":"string","description":"Timestamp de criação ISO 8601."},"updatedAt":{"type":"string","description":"Timestamp de última atualização ISO 8601."}},"required":["id","officeId","name","description","url","events","isActive","headers","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Deletar webhook","tags":["Webhooks"],"description":"Exclui permanentemente um webhook e o histórico associado de entregas. Esta ação não pode ser desfeita.","parameters":[{"schema":{"type":"string"},"in":"path","name":"webhookId","required":true,"description":"ID único do webhook a ser deletado."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"],"nullable":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/webhooks/{webhookId}/test":{"post":{"summary":"Enviar um evento de teste","tags":["Webhooks"],"description":"Envia um evento `webhook.test` sincronamente para a URL do webhook e retorna o resultado imediatamente. Use isso para verificar se seu endpoint está acessível e configurado corretamente.","parameters":[{"schema":{"type":"string"},"in":"path","name":"webhookId","required":true,"description":"ID único do webhook a ser testado."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"deliveryId":{"type":"string","description":"ID do registro de entrega criado para este teste. Use-o para inspecionar a resposta completa."},"success":{"type":"boolean","description":"Se o servidor de destino respondeu com um código de status 2xx."},"statusCode":{"type":"number","nullable":true,"description":"Código de status HTTP retornado pelo servidor de destino (0 se ocorreu um erro de rede)."},"durationMs":{"type":"number","nullable":true,"description":"Tempo de ida e volta em milissegundos desde o envio da requisição até a recepção da resposta."},"errorMessage":{"type":"string","nullable":true,"description":"Descrição do erro se a entrega falhou (null em caso de sucesso)."}},"required":["deliveryId","success","statusCode","durationMs","errorMessage"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/webhooks/{webhookId}/deliveries":{"get":{"summary":"Listar histórico de entregas","tags":["Webhooks"],"description":"Retorna uma lista paginada de tentativas de entrega para um webhook, ordenada pela mais recente primeiro. Registros são mantidos por 90 dias.","parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"default":1},"in":"query","name":"page","required":false,"description":"Número da página (1-indexado)."},{"schema":{"type":"integer","exclusiveMinimum":0,"maximum":100,"default":20},"in":"query","name":"limit","required":false,"description":"Número de registros por página (máximo 100)."},{"schema":{"type":"string","enum":["PENDING","SUCCESS","FAILED","RETRYING"]},"in":"query","name":"status","required":false,"description":"Filtrar por status de entrega."},{"schema":{"type":"string"},"in":"query","name":"event","required":false,"description":"Filtrar por nome de evento (ex.: `chat.conversation.created`)."},{"schema":{"type":"string"},"in":"path","name":"webhookId","required":true,"description":"Identificador único do webhook."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID único da tentativa de entrega."},"webhookId":{"type":"string","description":"ID do webhook a qual esta entrega pertence."},"event":{"type":"string","description":"Nome do evento que disparou esta entrega."},"status":{"type":"string","enum":["PENDING","SUCCESS","FAILED","RETRYING"],"description":"Status atual da entrega. `RETRYING` significa que uma nova tentativa de entrega está agendada; `FAILED` significa que todas as tentativas foram esgotadas."},"statusCode":{"type":"number","nullable":true,"description":"Código de status HTTP retornado pelo servidor de destino (null se ainda não foi entregue)."},"payload":{"type":"object","additionalProperties":{},"description":"O payload JSON exato que foi (ou será) enviado para a URL de destino."},"responseBody":{"type":"string","nullable":true,"description":"Primeiros 10,000 caracteres do corpo da resposta do servidor de destino."},"errorMessage":{"type":"string","nullable":true,"description":"Descrição legível do erro se a entrega falhou."},"durationMs":{"type":"number","nullable":true,"description":"Tempo de ida e volta da entrega em milissegundos."},"attemptCount":{"type":"number","description":"Quantas tentativas de entrega foram feitas até o momento."},"nextRetryAt":{"type":"string","nullable":true,"description":"Timestamp ISO 8601 da próxima tentativa de entrega agendada (null se nenhuma tentativa de entrega está pendente)."},"createdAt":{"type":"string","description":"Timestamp ISO 8601 quando esta entrega foi criada pela primeira vez."},"expiresAt":{"type":"string","description":"Timestamp ISO 8601 após o qual este registro será automaticamente deletado (retenção de 90 dias)."}},"required":["id","webhookId","event","status","statusCode","payload","responseBody","errorMessage","durationMs","attemptCount","nextRetryAt","createdAt","expiresAt"],"additionalProperties":false}},"total":{"type":"number","description":"Total de registros que correspondem ao filtro."},"page":{"type":"number","description":"Número da página atual."},"limit":{"type":"number","description":"Número de registros por página."},"totalPages":{"type":"number","description":"Total de páginas."}},"required":["data","total","page","limit","totalPages"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/webhooks/{webhookId}/deliveries/{deliveryId}":{"get":{"summary":"Obter uma entrega","tags":["Webhooks"],"description":"Retorna os detalhes completos de uma tentativa de entrega, incluindo o payload exato enviado e a resposta recebida.","parameters":[{"schema":{"type":"string"},"in":"path","name":"webhookId","required":true,"description":"ID único do webhook."},{"schema":{"type":"string"},"in":"path","name":"deliveryId","required":true,"description":"ID único da tentativa de entrega."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID único da tentativa de entrega."},"webhookId":{"type":"string","description":"ID do webhook a qual esta entrega pertence."},"event":{"type":"string","description":"Nome do evento que disparou esta entrega."},"status":{"type":"string","enum":["PENDING","SUCCESS","FAILED","RETRYING"],"description":"Status atual da entrega. `RETRYING` significa que uma nova tentativa de entrega está agendada; `FAILED` significa que todas as tentativas foram esgotadas."},"statusCode":{"type":"number","nullable":true,"description":"Código de status HTTP retornado pelo servidor de destino (null se ainda não foi entregue)."},"payload":{"type":"object","additionalProperties":{},"description":"O payload JSON exato que foi (ou será) enviado para a URL de destino."},"responseBody":{"type":"string","nullable":true,"description":"Primeiros 10,000 caracteres do corpo da resposta do servidor de destino."},"errorMessage":{"type":"string","nullable":true,"description":"Descrição legível do erro se a entrega falhou."},"durationMs":{"type":"number","nullable":true,"description":"Tempo de ida e volta da entrega em milissegundos."},"attemptCount":{"type":"number","description":"Quantas tentativas de entrega foram feitas até o momento."},"nextRetryAt":{"type":"string","nullable":true,"description":"Timestamp ISO 8601 da próxima tentativa de entrega agendada (null se nenhuma tentativa de entrega está pendente)."},"createdAt":{"type":"string","description":"Timestamp ISO 8601 quando esta entrega foi criada pela primeira vez."},"expiresAt":{"type":"string","description":"Timestamp ISO 8601 após o qual este registro será automaticamente deletado (retenção de 90 dias)."}},"required":["id","webhookId","event","status","statusCode","payload","responseBody","errorMessage","durationMs","attemptCount","nextRetryAt","createdAt","expiresAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/webhooks/deliveries/{deliveryId}/retry":{"post":{"summary":"Retentar uma entrega","tags":["Webhooks"],"description":"Reenfileira manualmente uma entrega com status `FAILED` ou `RETRYING`. Somente entregas nesses status podem ser reprocessadas. O status volta para `PENDING` e uma nova tentativa é agendada imediatamente.","parameters":[{"schema":{"type":"string"},"in":"path","name":"deliveryId","required":true,"description":"ID único da tentativa de entrega a ser retentada."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"deliveryId":{"type":"string","description":"ID da tentativa de entrega que foi reenfileirada."},"message":{"type":"string","description":"Mensagem de confirmação."}},"required":["deliveryId","message"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/automation-rules/":{"post":{"summary":"Criar regra de automação","tags":["Automation Rules"],"description":"Cria uma regra que reage a um evento do sistema e executa uma ou mais ações internas em ordem.\n\n**Como montar**\n\n1. `triggerEvent`: pegue o `name` em `GET /webhooks/events` — é o mesmo catálogo dos webhooks.\n2. `conditions` (opcional): filtra o *Quando*. Sem nenhuma condição efetiva, `elseActions` é recusado.\n3. `actions`: de 1 a 5 ações do ramo *Então*. `elseActions`: até 5 ações do ramo *Senão*.\n4. `integrationId`: `null` aplica a regra a todas as integrações. Ids em `GET /integration`.\n\n**Parâmetros por ação** (`actions[].actionParams`)\n\n| `action` | chave obrigatória | de onde vem o id |\n| --- | --- | --- |\n| `SEND_FAST_MESSAGE` | `fastMessageId` **ou** `templateName` | `createConversation` (default true) opcional. Ids em `GET /fast-message?inboxId={inboxId}` |\n| `SCHEDULE_MESSAGE` | `text` **ou** `templateName` | `createConversation` (default true) opcional |\n| `MOVE_CARD` | `targetFunnelColumnId` | `GET /funnel-column` |\n| `TAG_CONVERSATION` | `tagId` | `GET /tag` |\n| `ASSIGN_LEGAL_AREA` | `legalAreaId` | `GET /legal-areas` |\n| `CREATE_TICKET` | `title` | status em `GET /ticket-statuses` |\n| `FIRE_WEBHOOK` | `url` (http/https) | — |\n| `PAUSE_AUTOMATION` | nenhuma | `durationMinutes` opcional; `resumeOnTemplateSent` opcional |\n| `SEND_INSTAGRAM_REPLY` | `text` | `publicReplyText` e `createConversation` (default true) opcionais |\n| `CREATE_JURIDIQ_TASK` | `columnId` (uuid) e `title` (até 190) | coluna em `GET /integration/juridiq/task-boards`. Só com `crm.lead.moved`. `mode`: `template` (default) ou `modal` (só no Então, com coluna de origem ou destino no Quando). Variáveis {{nome}}, {{telefone}}, {{funil}} e {{coluna}} |\n| `UPDATE_CUSTOM_FIELD` | `customFieldId` + `value` | `GET /funnel-custom-field?funnelId={funnelId}`. Grava no card do lead no funil do campo |\n| `CLOSE_CONVERSATION` | nenhuma | Encerra a conversa depois das outras ações da regra. Conversa já encerrada fica como está |\n\n**Exemplo — enviar uma resposta rápida quando o lead entra numa coluna**\n\n```json\n{\n  \"name\": \"Boas-vindas do funil\",\n  \"enabled\": true,\n  \"triggerEvent\": \"crm.lead.created\",\n  \"conditions\": { \"funnelColumnId\": \"<id de GET /funnel-column>\" },\n  \"actions\": [\n    {\n      \"action\": \"SEND_FAST_MESSAGE\",\n      \"actionParams\": { \"fastMessageId\": \"<id de GET /fast-message?inboxId=...>\" }\n    }\n  ]\n}\n```\n\nA resposta rápida pode ser `TEXT`, `AUDIO` ou `SEQUENCE`. Numa `SEQUENCE`, os blocos saem\nem ordem, no ritmo (`typingSeconds` / `waitSeconds`) salvo na própria resposta rápida.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100,"description":"Nome da regra."},"enabled":{"type":"boolean","default":false,"description":"Indica se a regra está ativa."},"triggerEvent":{"type":"string","enum":["crm.lead.created","crm.lead.updated","crm.lead.deleted","crm.lead.moved","crm.lead.overdue","chat.conversation.created","chat.conversation.updated","chat.conversation.assigned","chat.conversation.no_reply","chat.message.received","chat.message.sent","contact.created","contact.updated","contact.deleted","instagram.direct.received","instagram.comment.received","instagram.story_mention.received","instagram.story_reply.received","instagram.ice_breaker.received","webhook.test"],"description":"Evento que dispara a automação."},"integrationId":{"type":"string","nullable":true,"description":"ID da integração. Null para aplicar a todas."},"conditions":{"type":"object","properties":{"funnelColumnId":{"type":"string","description":"Restringe a automação à coluna atual do lead (crm.lead.created/updated/overdue, chat.message.* e chat.conversation.no_reply)."},"fromFunnelColumnId":{"type":"string","description":"Restringe a automação a leads movidos a partir dessa coluna (crm.lead.moved)."},"toFunnelColumnId":{"type":"string","description":"Restringe a automação a leads movidos para essa coluna (crm.lead.moved)."},"status":{"type":"string","enum":["INACTIVE","ROBOT_INTERACTIVE","HUMAN_INTERACTIVE","WAITING_HUMAN","PAUSED"],"description":"Restringe a automação a esse status da conversa (chat.conversation.updated)."},"assignedToUserId":{"type":"string","description":"Restringe a automação a atribuições para esse usuário (chat.conversation.assigned)."},"assignedToDepartmentId":{"type":"string","description":"Restringe a automação quando esse setor estiver entre os atribuídos (chat.conversation.assigned.assignedToDepartmentIds)."},"messageText":{"type":"string","minLength":1,"description":"Compara o texto da mensagem (chat.message.received/sent)."},"messageMatchMode":{"type":"string","enum":["equals","contains","not_equals"],"description":"Modo de comparação do texto: equals, contains ou not_equals (default contains). not_equals casa texto diferente, inclusive mensagem sem texto."},"instagramAudience":{"type":"string","enum":["follower","not_follower"],"description":"Em eventos instagram.*, restringe a quem segue ou a quem não segue o perfil. Ausente vale para os dois."},"instagramPostId":{"type":"string","minLength":1,"description":"Em instagram.comment.received, restringe a esse id de publicação."},"iceBreakerId":{"type":"string","minLength":1,"maxLength":80,"description":"Identificador da pergunta cadastrada na conta. Em instagram.ice_breaker.received, só essa pergunta dispara a regra."},"templateName":{"type":"string","minLength":1,"description":"Nome do template da API oficial (igualdade exata). Em chat.message.received, refere-se ao template respondido (botão ou mensagem anterior). Com messageText, o template é o vínculo: a regra (Então e Senão) só considera respostas àquele modelo."},"noReplyMinutes":{"type":"integer","minimum":1,"maximum":43200,"description":"Obrigatório e exclusivo de chat.conversation.no_reply: minutos (1 a 43200) desde a última mensagem do escritório sem resposta do contato."},"restartOnReturn":{"type":"boolean","description":"Quando true, permite que a sequência de SCHEDULE_MESSAGE dessa regra rode de novo toda vez que o lead retornar à coluna (após a passagem anterior terminar/ser cancelada). Default false: a sequência roda uma única vez por lead."},"silenceAgent":{"type":"boolean","description":"Só em chat.message.received. Quando true e a regra executar ações (Então ou Senão), o agente de IA não responde àquela mensagem do cliente. Default false."}},"additionalProperties":false,"nullable":true,"description":"Condições que restringem a execução da regra."},"actions":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string","enum":["MOVE_CARD","SCHEDULE_MESSAGE","TAG_CONVERSATION","ASSIGN_LEGAL_AREA","SEND_FAST_MESSAGE","CREATE_TICKET","FIRE_WEBHOOK","PAUSE_AUTOMATION","SEND_INSTAGRAM_REPLY","CREATE_JURIDIQ_TASK","UPDATE_CUSTOM_FIELD","CLOSE_CONVERSATION"],"description":"Tipo da ação a executar."},"actionParams":{"anyOf":[{"type":"object","properties":{"targetFunnelColumnId":{"type":"string","description":"Coluna de destino do card. Obtenha o id em `GET /funnel-column`."}},"required":["targetFunnelColumnId"],"additionalProperties":true,"description":"MOVE_CARD — move o card do lead para outra coluna do funil."},{"type":"object","properties":{"tagId":{"type":"string","description":"Etiqueta a aplicar na conversa. Obtenha o id em `GET /tag`."}},"required":["tagId"],"additionalProperties":true,"description":"TAG_CONVERSATION — etiqueta a conversa."},{"type":"object","properties":{"legalAreaId":{"type":"string","description":"Área do direito a atribuir. Obtenha o id em `GET /legal-areas`."}},"required":["legalAreaId"],"additionalProperties":true,"description":"ASSIGN_LEGAL_AREA — atribui a área do direito à conversa."},{"type":"object","properties":{"url":{"type":"string","description":"URL http(s) absoluta que recebe o POST. Timeout de 10 segundos."}},"required":["url"],"additionalProperties":true,"description":"FIRE_WEBHOOK — dispara um POST para uma URL externa."},{"type":"object","properties":{"title":{"type":"string","description":"Título do ticket."},"description":{"type":"string","description":"Descrição do ticket."},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"description":"Prioridade do ticket. Default LOW."},"statusId":{"type":"string","description":"Status inicial. Obtenha o id em `GET /ticket-statuses`. Ausente usa o default."},"assigneeIds":{"type":"array","items":{"type":"string"},"description":"Responsáveis pelo ticket. Obtenha os ids em `GET /user`."},"departmentIds":{"type":"array","items":{"type":"string"},"description":"Setores do ticket. Obtenha os ids em `GET /departments`."},"linkConversation":{"type":"boolean","description":"Vincula a conversa que disparou o evento ao ticket. Default true."}},"required":["title"],"additionalProperties":true,"description":"CREATE_TICKET — abre um ticket."},{"type":"object","properties":{"durationMinutes":{"type":"integer","minimum":0,"maximum":43200,"description":"Minutos até reativar nesta conversa. Ausente ou 0: sem prazo (fica pausada até um evento de retomada). Máximo 43200 (30 dias)."},"resumeOnTemplateSent":{"type":"boolean","description":"Quando true, um template enviado nesta conversa depois da pausa reativa a regra. Default false na API; o builder liga por padrão."}},"additionalProperties":true,"description":"PAUSE_AUTOMATION — pausa esta regra nesta conversa. Outras automações continuam."},{"type":"object","properties":{"fastMessageId":{"type":"string","description":"Resposta rápida a enviar. Obtenha o id em `GET /fast-message?inboxId={inboxId}` — é o campo `id` da lista. Vale para todos os tipos: `TEXT`, `AUDIO`, `IMAGE`, `VIDEO`, `DOCUMENT` e `SEQUENCE` (a sequência sai bloco a bloco, no ritmo salvo). As variáveis `{{Contato.*}}` do texto e da legenda saem com os dados do contato; texto que fica vazio assim não é enviado. Obrigatório quando `templateName` não for enviado."},"templateName":{"type":"string","description":"Nome do template aprovado na API oficial. Liste os disponíveis em `GET /integration/templates/{integrationId}`."},"variables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do corpo do template, na ordem em que aparecem."},"bodyVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do corpo, na mesma ordem de `variables`."},"headerVariables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do cabeçalho do template."},"headerVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do cabeçalho, na mesma ordem de `headerVariables`."},"headerMedia":{"description":"Mídia do cabeçalho: `{ format: IMAGE | VIDEO | DOCUMENT | LOCATION, link, fileName, latitude, longitude, name, address }`."},"buttonVariables":{"description":"Variáveis de botões dinâmicos: `[{ index, parameters: string[], parameterNames?: string[] }]`."},"createConversation":{"type":"boolean","description":"Abre um atendimento no número de WhatsApp quando o contato ainda não tem conversa. Default true. False não envia se não houver conversa."}},"additionalProperties":true,"description":"SEND_FAST_MESSAGE — envia uma resposta rápida na conversa. Informe `fastMessageId` OU `templateName`."},{"type":"object","properties":{"text":{"type":"string","description":"Texto da mensagem. Obrigatório quando `templateName` não for enviado."},"delayMinutes":{"type":"number","description":"Minutos de espera entre o disparo do evento e o envio. Ausente envia na hora."},"sendWindowEnabled":{"type":"boolean","description":"Quando true, o envio é adiado para dentro da janela abaixo."},"sendWindowStart":{"type":"string","description":"Início da janela de envio, `HH:mm` no fuso America/Sao_Paulo."},"sendWindowEnd":{"type":"string","description":"Fim da janela de envio, `HH:mm` no fuso America/Sao_Paulo."},"templateName":{"type":"string","description":"Nome do template aprovado na API oficial. Liste os disponíveis em `GET /integration/templates/{integrationId}`."},"variables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do corpo do template, na ordem em que aparecem."},"bodyVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do corpo, na mesma ordem de `variables`."},"headerVariables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do cabeçalho do template."},"headerVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do cabeçalho, na mesma ordem de `headerVariables`."},"headerMedia":{"description":"Mídia do cabeçalho: `{ format: IMAGE | VIDEO | DOCUMENT | LOCATION, link, fileName, latitude, longitude, name, address }`."},"buttonVariables":{"description":"Variáveis de botões dinâmicos: `[{ index, parameters: string[], parameterNames?: string[] }]`."},"createConversation":{"type":"boolean","description":"Abre um atendimento no número de WhatsApp quando o contato ainda não tem conversa. Default true. False não agenda se não houver conversa."}},"additionalProperties":true,"description":"SCHEDULE_MESSAGE — agenda uma mensagem na conversa. Informe `text` OU `templateName`."},{"type":"object","properties":{"text":{"type":"string","description":"Texto enviado no Direct."},"publicReplyText":{"type":"string","description":"Resposta pública no comentário. Só vale em instagram.comment.received."},"createConversation":{"type":"boolean","description":"Abre um atendimento no JuriChat com quem comentou. Default true. False responde no Instagram sem criar conversa."}},"required":["text"],"additionalProperties":true,"description":"SEND_INSTAGRAM_REPLY — responde no Instagram."},{"type":"object","properties":{"mode":{"type":"string","enum":["template","modal"],"description":"`template` (default): cria a tarefa sozinha a cada entrada na coluna, inclusive por bot, fluxo, IA e migração em lote. `modal`: no Kanban, quem arrastou o card confirma e ajusta antes de enviar; a automação em si não cria nada. Só no Então, e com coluna de origem ou de destino no Quando."},"columnId":{"type":"string","description":"Coluna de tarefas do Juridiq (define quadro e pasta). Obtenha o id em `GET /integration/juridiq/task-boards`."},"title":{"type":"string","description":"Título da tarefa, até 190 caracteres. Aceita {{nome}}, {{telefone}}, {{funil}} e {{coluna}}."},"description":{"type":"string","description":"Descrição da tarefa. Aceita as mesmas variáveis do título."}},"required":["columnId","title"],"additionalProperties":true,"description":"CREATE_JURIDIQ_TASK — cria uma tarefa no Juridiq, prioridade Baixa, com a data de hoje e a pessoa vinculada ao contato. Só com o gatilho crm.lead.moved."},{"type":"object","properties":{"customFieldId":{"type":"string","description":"Campo personalizado do funil. Obtenha o id em `GET /funnel-custom-field?funnelId={funnelId}`."},"value":{"type":"string","description":"Valor gravado no card do lead. `multiselect` separa as opções por vírgula; `date` usa `YYYY-MM-DD`. Vazio limpa o campo."}},"required":["customFieldId","value"],"additionalProperties":true,"description":"UPDATE_CUSTOM_FIELD — preenche um campo personalizado no card do lead, no funil do campo."},{"type":"object","properties":{},"additionalProperties":true,"description":"CLOSE_CONVERSATION — encerra a conversa (como o botão Encerrar do atendente). Sem parâmetros. Roda depois das outras ações da regra."},{"type":"object","additionalProperties":{},"description":"Qualquer outro conjunto de parâmetros."}],"description":"Parâmetros da ação. As chaves dependem do valor de `action` — cada alternativa abaixo é a de uma ação."}},"required":["action","actionParams"],"additionalProperties":false},"minItems":1,"maxItems":5,"description":"Ações do ramo Então, executadas quando a condição do Quando é verdadeira."},"elseActions":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string","enum":["MOVE_CARD","SCHEDULE_MESSAGE","TAG_CONVERSATION","ASSIGN_LEGAL_AREA","SEND_FAST_MESSAGE","CREATE_TICKET","FIRE_WEBHOOK","PAUSE_AUTOMATION","SEND_INSTAGRAM_REPLY","CREATE_JURIDIQ_TASK","UPDATE_CUSTOM_FIELD","CLOSE_CONVERSATION"],"description":"Tipo da ação a executar."},"actionParams":{"anyOf":[{"type":"object","properties":{"targetFunnelColumnId":{"type":"string","description":"Coluna de destino do card. Obtenha o id em `GET /funnel-column`."}},"required":["targetFunnelColumnId"],"additionalProperties":true,"description":"MOVE_CARD — move o card do lead para outra coluna do funil."},{"type":"object","properties":{"tagId":{"type":"string","description":"Etiqueta a aplicar na conversa. Obtenha o id em `GET /tag`."}},"required":["tagId"],"additionalProperties":true,"description":"TAG_CONVERSATION — etiqueta a conversa."},{"type":"object","properties":{"legalAreaId":{"type":"string","description":"Área do direito a atribuir. Obtenha o id em `GET /legal-areas`."}},"required":["legalAreaId"],"additionalProperties":true,"description":"ASSIGN_LEGAL_AREA — atribui a área do direito à conversa."},{"type":"object","properties":{"url":{"type":"string","description":"URL http(s) absoluta que recebe o POST. Timeout de 10 segundos."}},"required":["url"],"additionalProperties":true,"description":"FIRE_WEBHOOK — dispara um POST para uma URL externa."},{"type":"object","properties":{"title":{"type":"string","description":"Título do ticket."},"description":{"type":"string","description":"Descrição do ticket."},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"description":"Prioridade do ticket. Default LOW."},"statusId":{"type":"string","description":"Status inicial. Obtenha o id em `GET /ticket-statuses`. Ausente usa o default."},"assigneeIds":{"type":"array","items":{"type":"string"},"description":"Responsáveis pelo ticket. Obtenha os ids em `GET /user`."},"departmentIds":{"type":"array","items":{"type":"string"},"description":"Setores do ticket. Obtenha os ids em `GET /departments`."},"linkConversation":{"type":"boolean","description":"Vincula a conversa que disparou o evento ao ticket. Default true."}},"required":["title"],"additionalProperties":true,"description":"CREATE_TICKET — abre um ticket."},{"type":"object","properties":{"durationMinutes":{"type":"integer","minimum":0,"maximum":43200,"description":"Minutos até reativar nesta conversa. Ausente ou 0: sem prazo (fica pausada até um evento de retomada). Máximo 43200 (30 dias)."},"resumeOnTemplateSent":{"type":"boolean","description":"Quando true, um template enviado nesta conversa depois da pausa reativa a regra. Default false na API; o builder liga por padrão."}},"additionalProperties":true,"description":"PAUSE_AUTOMATION — pausa esta regra nesta conversa. Outras automações continuam."},{"type":"object","properties":{"fastMessageId":{"type":"string","description":"Resposta rápida a enviar. Obtenha o id em `GET /fast-message?inboxId={inboxId}` — é o campo `id` da lista. Vale para todos os tipos: `TEXT`, `AUDIO`, `IMAGE`, `VIDEO`, `DOCUMENT` e `SEQUENCE` (a sequência sai bloco a bloco, no ritmo salvo). As variáveis `{{Contato.*}}` do texto e da legenda saem com os dados do contato; texto que fica vazio assim não é enviado. Obrigatório quando `templateName` não for enviado."},"templateName":{"type":"string","description":"Nome do template aprovado na API oficial. Liste os disponíveis em `GET /integration/templates/{integrationId}`."},"variables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do corpo do template, na ordem em que aparecem."},"bodyVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do corpo, na mesma ordem de `variables`."},"headerVariables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do cabeçalho do template."},"headerVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do cabeçalho, na mesma ordem de `headerVariables`."},"headerMedia":{"description":"Mídia do cabeçalho: `{ format: IMAGE | VIDEO | DOCUMENT | LOCATION, link, fileName, latitude, longitude, name, address }`."},"buttonVariables":{"description":"Variáveis de botões dinâmicos: `[{ index, parameters: string[], parameterNames?: string[] }]`."},"createConversation":{"type":"boolean","description":"Abre um atendimento no número de WhatsApp quando o contato ainda não tem conversa. Default true. False não envia se não houver conversa."}},"additionalProperties":true,"description":"SEND_FAST_MESSAGE — envia uma resposta rápida na conversa. Informe `fastMessageId` OU `templateName`."},{"type":"object","properties":{"text":{"type":"string","description":"Texto da mensagem. Obrigatório quando `templateName` não for enviado."},"delayMinutes":{"type":"number","description":"Minutos de espera entre o disparo do evento e o envio. Ausente envia na hora."},"sendWindowEnabled":{"type":"boolean","description":"Quando true, o envio é adiado para dentro da janela abaixo."},"sendWindowStart":{"type":"string","description":"Início da janela de envio, `HH:mm` no fuso America/Sao_Paulo."},"sendWindowEnd":{"type":"string","description":"Fim da janela de envio, `HH:mm` no fuso America/Sao_Paulo."},"templateName":{"type":"string","description":"Nome do template aprovado na API oficial. Liste os disponíveis em `GET /integration/templates/{integrationId}`."},"variables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do corpo do template, na ordem em que aparecem."},"bodyVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do corpo, na mesma ordem de `variables`."},"headerVariables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do cabeçalho do template."},"headerVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do cabeçalho, na mesma ordem de `headerVariables`."},"headerMedia":{"description":"Mídia do cabeçalho: `{ format: IMAGE | VIDEO | DOCUMENT | LOCATION, link, fileName, latitude, longitude, name, address }`."},"buttonVariables":{"description":"Variáveis de botões dinâmicos: `[{ index, parameters: string[], parameterNames?: string[] }]`."},"createConversation":{"type":"boolean","description":"Abre um atendimento no número de WhatsApp quando o contato ainda não tem conversa. Default true. False não agenda se não houver conversa."}},"additionalProperties":true,"description":"SCHEDULE_MESSAGE — agenda uma mensagem na conversa. Informe `text` OU `templateName`."},{"type":"object","properties":{"text":{"type":"string","description":"Texto enviado no Direct."},"publicReplyText":{"type":"string","description":"Resposta pública no comentário. Só vale em instagram.comment.received."},"createConversation":{"type":"boolean","description":"Abre um atendimento no JuriChat com quem comentou. Default true. False responde no Instagram sem criar conversa."}},"required":["text"],"additionalProperties":true,"description":"SEND_INSTAGRAM_REPLY — responde no Instagram."},{"type":"object","properties":{"mode":{"type":"string","enum":["template","modal"],"description":"`template` (default): cria a tarefa sozinha a cada entrada na coluna, inclusive por bot, fluxo, IA e migração em lote. `modal`: no Kanban, quem arrastou o card confirma e ajusta antes de enviar; a automação em si não cria nada. Só no Então, e com coluna de origem ou de destino no Quando."},"columnId":{"type":"string","description":"Coluna de tarefas do Juridiq (define quadro e pasta). Obtenha o id em `GET /integration/juridiq/task-boards`."},"title":{"type":"string","description":"Título da tarefa, até 190 caracteres. Aceita {{nome}}, {{telefone}}, {{funil}} e {{coluna}}."},"description":{"type":"string","description":"Descrição da tarefa. Aceita as mesmas variáveis do título."}},"required":["columnId","title"],"additionalProperties":true,"description":"CREATE_JURIDIQ_TASK — cria uma tarefa no Juridiq, prioridade Baixa, com a data de hoje e a pessoa vinculada ao contato. Só com o gatilho crm.lead.moved."},{"type":"object","properties":{"customFieldId":{"type":"string","description":"Campo personalizado do funil. Obtenha o id em `GET /funnel-custom-field?funnelId={funnelId}`."},"value":{"type":"string","description":"Valor gravado no card do lead. `multiselect` separa as opções por vírgula; `date` usa `YYYY-MM-DD`. Vazio limpa o campo."}},"required":["customFieldId","value"],"additionalProperties":true,"description":"UPDATE_CUSTOM_FIELD — preenche um campo personalizado no card do lead, no funil do campo."},{"type":"object","properties":{},"additionalProperties":true,"description":"CLOSE_CONVERSATION — encerra a conversa (como o botão Encerrar do atendente). Sem parâmetros. Roda depois das outras ações da regra."},{"type":"object","additionalProperties":{},"description":"Qualquer outro conjunto de parâmetros."}],"description":"Parâmetros da ação. As chaves dependem do valor de `action` — cada alternativa abaixo é a de uma ação."}},"required":["action","actionParams"],"additionalProperties":false},"maxItems":5,"nullable":true,"description":"Ações do ramo Senão, executadas quando a condição do Quando é falsa."},"priority":{"type":"integer","default":0,"description":"Prioridade da regra."}},"required":["name","triggerEvent","actions"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"officeId":{"type":"string"},"integrationId":{"type":"string","nullable":true},"name":{"type":"string"},"enabled":{"type":"boolean"},"triggerEvent":{"type":"string"},"conditions":{"type":"object","additionalProperties":{},"nullable":true},"actions":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string"},"actionParams":{"type":"object","additionalProperties":{}}},"required":["action","actionParams"],"additionalProperties":false}},"elseActions":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string"},"actionParams":{"type":"object","additionalProperties":{}}},"required":["action","actionParams"],"additionalProperties":false},"nullable":true},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","officeId","integrationId","name","enabled","triggerEvent","conditions","actions","elseActions","priority","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"get":{"summary":"Listar regras de automação","tags":["Automation Rules"],"description":"Lista as regras de automação do escritório, opcionalmente filtradas por evento.","parameters":[{"schema":{"type":"string"},"in":"query","name":"triggerEvent","required":false,"description":"Filtra regras pelo evento disparador (ex.: crm.lead.moved)."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"officeId":{"type":"string"},"integrationId":{"type":"string","nullable":true},"name":{"type":"string"},"enabled":{"type":"boolean"},"triggerEvent":{"type":"string"},"conditions":{"type":"object","additionalProperties":{},"nullable":true},"actions":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string"},"actionParams":{"type":"object","additionalProperties":{}}},"required":["action","actionParams"],"additionalProperties":false}},"elseActions":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string"},"actionParams":{"type":"object","additionalProperties":{}}},"required":["action","actionParams"],"additionalProperties":false},"nullable":true},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","officeId","integrationId","name","enabled","triggerEvent","conditions","actions","elseActions","priority","createdAt","updatedAt"],"additionalProperties":false}}}}}}}},"/automation-rules/{id}":{"get":{"summary":"Buscar regra de automação","tags":["Automation Rules"],"description":"Retorna os detalhes de uma regra de automação.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID da regra de automação."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"officeId":{"type":"string"},"integrationId":{"type":"string","nullable":true},"name":{"type":"string"},"enabled":{"type":"boolean"},"triggerEvent":{"type":"string"},"conditions":{"type":"object","additionalProperties":{},"nullable":true},"actions":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string"},"actionParams":{"type":"object","additionalProperties":{}}},"required":["action","actionParams"],"additionalProperties":false}},"elseActions":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string"},"actionParams":{"type":"object","additionalProperties":{}}},"required":["action","actionParams"],"additionalProperties":false},"nullable":true},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","officeId","integrationId","name","enabled","triggerEvent","conditions","actions","elseActions","priority","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Atualizar regra de automação","tags":["Automation Rules"],"description":"Atualiza parcialmente uma regra de automação. Remover o filtro IF limpa o ramo Senão, mesmo que elseActions ainda exista no payload ou no banco.\n\n**Como montar**\n\n1. `triggerEvent`: pegue o `name` em `GET /webhooks/events` — é o mesmo catálogo dos webhooks.\n2. `conditions` (opcional): filtra o *Quando*. Sem nenhuma condição efetiva, `elseActions` é recusado.\n3. `actions`: de 1 a 5 ações do ramo *Então*. `elseActions`: até 5 ações do ramo *Senão*.\n4. `integrationId`: `null` aplica a regra a todas as integrações. Ids em `GET /integration`.\n\n**Parâmetros por ação** (`actions[].actionParams`)\n\n| `action` | chave obrigatória | de onde vem o id |\n| --- | --- | --- |\n| `SEND_FAST_MESSAGE` | `fastMessageId` **ou** `templateName` | `createConversation` (default true) opcional. Ids em `GET /fast-message?inboxId={inboxId}` |\n| `SCHEDULE_MESSAGE` | `text` **ou** `templateName` | `createConversation` (default true) opcional |\n| `MOVE_CARD` | `targetFunnelColumnId` | `GET /funnel-column` |\n| `TAG_CONVERSATION` | `tagId` | `GET /tag` |\n| `ASSIGN_LEGAL_AREA` | `legalAreaId` | `GET /legal-areas` |\n| `CREATE_TICKET` | `title` | status em `GET /ticket-statuses` |\n| `FIRE_WEBHOOK` | `url` (http/https) | — |\n| `PAUSE_AUTOMATION` | nenhuma | `durationMinutes` opcional; `resumeOnTemplateSent` opcional |\n| `SEND_INSTAGRAM_REPLY` | `text` | `publicReplyText` e `createConversation` (default true) opcionais |\n| `CREATE_JURIDIQ_TASK` | `columnId` (uuid) e `title` (até 190) | coluna em `GET /integration/juridiq/task-boards`. Só com `crm.lead.moved`. `mode`: `template` (default) ou `modal` (só no Então, com coluna de origem ou destino no Quando). Variáveis {{nome}}, {{telefone}}, {{funil}} e {{coluna}} |\n| `UPDATE_CUSTOM_FIELD` | `customFieldId` + `value` | `GET /funnel-custom-field?funnelId={funnelId}`. Grava no card do lead no funil do campo |\n| `CLOSE_CONVERSATION` | nenhuma | Encerra a conversa depois das outras ações da regra. Conversa já encerrada fica como está |\n\n**Exemplo — enviar uma resposta rápida quando o lead entra numa coluna**\n\n```json\n{\n  \"name\": \"Boas-vindas do funil\",\n  \"enabled\": true,\n  \"triggerEvent\": \"crm.lead.created\",\n  \"conditions\": { \"funnelColumnId\": \"<id de GET /funnel-column>\" },\n  \"actions\": [\n    {\n      \"action\": \"SEND_FAST_MESSAGE\",\n      \"actionParams\": { \"fastMessageId\": \"<id de GET /fast-message?inboxId=...>\" }\n    }\n  ]\n}\n```\n\nA resposta rápida pode ser `TEXT`, `AUDIO` ou `SEQUENCE`. Numa `SEQUENCE`, os blocos saem\nem ordem, no ritmo (`typingSeconds` / `waitSeconds`) salvo na própria resposta rápida.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100,"description":"Nome da regra."},"enabled":{"type":"boolean","description":"Indica se a regra está ativa."},"triggerEvent":{"type":"string","enum":["crm.lead.created","crm.lead.updated","crm.lead.deleted","crm.lead.moved","crm.lead.overdue","chat.conversation.created","chat.conversation.updated","chat.conversation.assigned","chat.conversation.no_reply","chat.message.received","chat.message.sent","contact.created","contact.updated","contact.deleted","instagram.direct.received","instagram.comment.received","instagram.story_mention.received","instagram.story_reply.received","instagram.ice_breaker.received","webhook.test"],"description":"Evento que dispara a automação."},"integrationId":{"type":"string","nullable":true,"description":"ID da integração. Null para aplicar a todas."},"conditions":{"type":"object","properties":{"funnelColumnId":{"type":"string","description":"Restringe a automação à coluna atual do lead (crm.lead.created/updated/overdue, chat.message.* e chat.conversation.no_reply)."},"fromFunnelColumnId":{"type":"string","description":"Restringe a automação a leads movidos a partir dessa coluna (crm.lead.moved)."},"toFunnelColumnId":{"type":"string","description":"Restringe a automação a leads movidos para essa coluna (crm.lead.moved)."},"status":{"type":"string","enum":["INACTIVE","ROBOT_INTERACTIVE","HUMAN_INTERACTIVE","WAITING_HUMAN","PAUSED"],"description":"Restringe a automação a esse status da conversa (chat.conversation.updated)."},"assignedToUserId":{"type":"string","description":"Restringe a automação a atribuições para esse usuário (chat.conversation.assigned)."},"assignedToDepartmentId":{"type":"string","description":"Restringe a automação quando esse setor estiver entre os atribuídos (chat.conversation.assigned.assignedToDepartmentIds)."},"messageText":{"type":"string","minLength":1,"description":"Compara o texto da mensagem (chat.message.received/sent)."},"messageMatchMode":{"type":"string","enum":["equals","contains","not_equals"],"description":"Modo de comparação do texto: equals, contains ou not_equals (default contains). not_equals casa texto diferente, inclusive mensagem sem texto."},"instagramAudience":{"type":"string","enum":["follower","not_follower"],"description":"Em eventos instagram.*, restringe a quem segue ou a quem não segue o perfil. Ausente vale para os dois."},"instagramPostId":{"type":"string","minLength":1,"description":"Em instagram.comment.received, restringe a esse id de publicação."},"iceBreakerId":{"type":"string","minLength":1,"maxLength":80,"description":"Identificador da pergunta cadastrada na conta. Em instagram.ice_breaker.received, só essa pergunta dispara a regra."},"templateName":{"type":"string","minLength":1,"description":"Nome do template da API oficial (igualdade exata). Em chat.message.received, refere-se ao template respondido (botão ou mensagem anterior). Com messageText, o template é o vínculo: a regra (Então e Senão) só considera respostas àquele modelo."},"noReplyMinutes":{"type":"integer","minimum":1,"maximum":43200,"description":"Obrigatório e exclusivo de chat.conversation.no_reply: minutos (1 a 43200) desde a última mensagem do escritório sem resposta do contato."},"restartOnReturn":{"type":"boolean","description":"Quando true, permite que a sequência de SCHEDULE_MESSAGE dessa regra rode de novo toda vez que o lead retornar à coluna (após a passagem anterior terminar/ser cancelada). Default false: a sequência roda uma única vez por lead."},"silenceAgent":{"type":"boolean","description":"Só em chat.message.received. Quando true e a regra executar ações (Então ou Senão), o agente de IA não responde àquela mensagem do cliente. Default false."}},"additionalProperties":false,"nullable":true,"description":"Condições que restringem a execução da regra."},"actions":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string","enum":["MOVE_CARD","SCHEDULE_MESSAGE","TAG_CONVERSATION","ASSIGN_LEGAL_AREA","SEND_FAST_MESSAGE","CREATE_TICKET","FIRE_WEBHOOK","PAUSE_AUTOMATION","SEND_INSTAGRAM_REPLY","CREATE_JURIDIQ_TASK","UPDATE_CUSTOM_FIELD","CLOSE_CONVERSATION"],"description":"Tipo da ação a executar."},"actionParams":{"anyOf":[{"type":"object","properties":{"targetFunnelColumnId":{"type":"string","description":"Coluna de destino do card. Obtenha o id em `GET /funnel-column`."}},"required":["targetFunnelColumnId"],"additionalProperties":true,"description":"MOVE_CARD — move o card do lead para outra coluna do funil."},{"type":"object","properties":{"tagId":{"type":"string","description":"Etiqueta a aplicar na conversa. Obtenha o id em `GET /tag`."}},"required":["tagId"],"additionalProperties":true,"description":"TAG_CONVERSATION — etiqueta a conversa."},{"type":"object","properties":{"legalAreaId":{"type":"string","description":"Área do direito a atribuir. Obtenha o id em `GET /legal-areas`."}},"required":["legalAreaId"],"additionalProperties":true,"description":"ASSIGN_LEGAL_AREA — atribui a área do direito à conversa."},{"type":"object","properties":{"url":{"type":"string","description":"URL http(s) absoluta que recebe o POST. Timeout de 10 segundos."}},"required":["url"],"additionalProperties":true,"description":"FIRE_WEBHOOK — dispara um POST para uma URL externa."},{"type":"object","properties":{"title":{"type":"string","description":"Título do ticket."},"description":{"type":"string","description":"Descrição do ticket."},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"description":"Prioridade do ticket. Default LOW."},"statusId":{"type":"string","description":"Status inicial. Obtenha o id em `GET /ticket-statuses`. Ausente usa o default."},"assigneeIds":{"type":"array","items":{"type":"string"},"description":"Responsáveis pelo ticket. Obtenha os ids em `GET /user`."},"departmentIds":{"type":"array","items":{"type":"string"},"description":"Setores do ticket. Obtenha os ids em `GET /departments`."},"linkConversation":{"type":"boolean","description":"Vincula a conversa que disparou o evento ao ticket. Default true."}},"required":["title"],"additionalProperties":true,"description":"CREATE_TICKET — abre um ticket."},{"type":"object","properties":{"durationMinutes":{"type":"integer","minimum":0,"maximum":43200,"description":"Minutos até reativar nesta conversa. Ausente ou 0: sem prazo (fica pausada até um evento de retomada). Máximo 43200 (30 dias)."},"resumeOnTemplateSent":{"type":"boolean","description":"Quando true, um template enviado nesta conversa depois da pausa reativa a regra. Default false na API; o builder liga por padrão."}},"additionalProperties":true,"description":"PAUSE_AUTOMATION — pausa esta regra nesta conversa. Outras automações continuam."},{"type":"object","properties":{"fastMessageId":{"type":"string","description":"Resposta rápida a enviar. Obtenha o id em `GET /fast-message?inboxId={inboxId}` — é o campo `id` da lista. Vale para todos os tipos: `TEXT`, `AUDIO`, `IMAGE`, `VIDEO`, `DOCUMENT` e `SEQUENCE` (a sequência sai bloco a bloco, no ritmo salvo). As variáveis `{{Contato.*}}` do texto e da legenda saem com os dados do contato; texto que fica vazio assim não é enviado. Obrigatório quando `templateName` não for enviado."},"templateName":{"type":"string","description":"Nome do template aprovado na API oficial. Liste os disponíveis em `GET /integration/templates/{integrationId}`."},"variables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do corpo do template, na ordem em que aparecem."},"bodyVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do corpo, na mesma ordem de `variables`."},"headerVariables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do cabeçalho do template."},"headerVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do cabeçalho, na mesma ordem de `headerVariables`."},"headerMedia":{"description":"Mídia do cabeçalho: `{ format: IMAGE | VIDEO | DOCUMENT | LOCATION, link, fileName, latitude, longitude, name, address }`."},"buttonVariables":{"description":"Variáveis de botões dinâmicos: `[{ index, parameters: string[], parameterNames?: string[] }]`."},"createConversation":{"type":"boolean","description":"Abre um atendimento no número de WhatsApp quando o contato ainda não tem conversa. Default true. False não envia se não houver conversa."}},"additionalProperties":true,"description":"SEND_FAST_MESSAGE — envia uma resposta rápida na conversa. Informe `fastMessageId` OU `templateName`."},{"type":"object","properties":{"text":{"type":"string","description":"Texto da mensagem. Obrigatório quando `templateName` não for enviado."},"delayMinutes":{"type":"number","description":"Minutos de espera entre o disparo do evento e o envio. Ausente envia na hora."},"sendWindowEnabled":{"type":"boolean","description":"Quando true, o envio é adiado para dentro da janela abaixo."},"sendWindowStart":{"type":"string","description":"Início da janela de envio, `HH:mm` no fuso America/Sao_Paulo."},"sendWindowEnd":{"type":"string","description":"Fim da janela de envio, `HH:mm` no fuso America/Sao_Paulo."},"templateName":{"type":"string","description":"Nome do template aprovado na API oficial. Liste os disponíveis em `GET /integration/templates/{integrationId}`."},"variables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do corpo do template, na ordem em que aparecem."},"bodyVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do corpo, na mesma ordem de `variables`."},"headerVariables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do cabeçalho do template."},"headerVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do cabeçalho, na mesma ordem de `headerVariables`."},"headerMedia":{"description":"Mídia do cabeçalho: `{ format: IMAGE | VIDEO | DOCUMENT | LOCATION, link, fileName, latitude, longitude, name, address }`."},"buttonVariables":{"description":"Variáveis de botões dinâmicos: `[{ index, parameters: string[], parameterNames?: string[] }]`."},"createConversation":{"type":"boolean","description":"Abre um atendimento no número de WhatsApp quando o contato ainda não tem conversa. Default true. False não agenda se não houver conversa."}},"additionalProperties":true,"description":"SCHEDULE_MESSAGE — agenda uma mensagem na conversa. Informe `text` OU `templateName`."},{"type":"object","properties":{"text":{"type":"string","description":"Texto enviado no Direct."},"publicReplyText":{"type":"string","description":"Resposta pública no comentário. Só vale em instagram.comment.received."},"createConversation":{"type":"boolean","description":"Abre um atendimento no JuriChat com quem comentou. Default true. False responde no Instagram sem criar conversa."}},"required":["text"],"additionalProperties":true,"description":"SEND_INSTAGRAM_REPLY — responde no Instagram."},{"type":"object","properties":{"mode":{"type":"string","enum":["template","modal"],"description":"`template` (default): cria a tarefa sozinha a cada entrada na coluna, inclusive por bot, fluxo, IA e migração em lote. `modal`: no Kanban, quem arrastou o card confirma e ajusta antes de enviar; a automação em si não cria nada. Só no Então, e com coluna de origem ou de destino no Quando."},"columnId":{"type":"string","description":"Coluna de tarefas do Juridiq (define quadro e pasta). Obtenha o id em `GET /integration/juridiq/task-boards`."},"title":{"type":"string","description":"Título da tarefa, até 190 caracteres. Aceita {{nome}}, {{telefone}}, {{funil}} e {{coluna}}."},"description":{"type":"string","description":"Descrição da tarefa. Aceita as mesmas variáveis do título."}},"required":["columnId","title"],"additionalProperties":true,"description":"CREATE_JURIDIQ_TASK — cria uma tarefa no Juridiq, prioridade Baixa, com a data de hoje e a pessoa vinculada ao contato. Só com o gatilho crm.lead.moved."},{"type":"object","properties":{"customFieldId":{"type":"string","description":"Campo personalizado do funil. Obtenha o id em `GET /funnel-custom-field?funnelId={funnelId}`."},"value":{"type":"string","description":"Valor gravado no card do lead. `multiselect` separa as opções por vírgula; `date` usa `YYYY-MM-DD`. Vazio limpa o campo."}},"required":["customFieldId","value"],"additionalProperties":true,"description":"UPDATE_CUSTOM_FIELD — preenche um campo personalizado no card do lead, no funil do campo."},{"type":"object","properties":{},"additionalProperties":true,"description":"CLOSE_CONVERSATION — encerra a conversa (como o botão Encerrar do atendente). Sem parâmetros. Roda depois das outras ações da regra."},{"type":"object","additionalProperties":{},"description":"Qualquer outro conjunto de parâmetros."}],"description":"Parâmetros da ação. As chaves dependem do valor de `action` — cada alternativa abaixo é a de uma ação."}},"required":["action","actionParams"],"additionalProperties":false},"minItems":1,"maxItems":5,"description":"Ações do ramo Então, executadas quando a condição é verdadeira."},"elseActions":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string","enum":["MOVE_CARD","SCHEDULE_MESSAGE","TAG_CONVERSATION","ASSIGN_LEGAL_AREA","SEND_FAST_MESSAGE","CREATE_TICKET","FIRE_WEBHOOK","PAUSE_AUTOMATION","SEND_INSTAGRAM_REPLY","CREATE_JURIDIQ_TASK","UPDATE_CUSTOM_FIELD","CLOSE_CONVERSATION"],"description":"Tipo da ação a executar."},"actionParams":{"anyOf":[{"type":"object","properties":{"targetFunnelColumnId":{"type":"string","description":"Coluna de destino do card. Obtenha o id em `GET /funnel-column`."}},"required":["targetFunnelColumnId"],"additionalProperties":true,"description":"MOVE_CARD — move o card do lead para outra coluna do funil."},{"type":"object","properties":{"tagId":{"type":"string","description":"Etiqueta a aplicar na conversa. Obtenha o id em `GET /tag`."}},"required":["tagId"],"additionalProperties":true,"description":"TAG_CONVERSATION — etiqueta a conversa."},{"type":"object","properties":{"legalAreaId":{"type":"string","description":"Área do direito a atribuir. Obtenha o id em `GET /legal-areas`."}},"required":["legalAreaId"],"additionalProperties":true,"description":"ASSIGN_LEGAL_AREA — atribui a área do direito à conversa."},{"type":"object","properties":{"url":{"type":"string","description":"URL http(s) absoluta que recebe o POST. Timeout de 10 segundos."}},"required":["url"],"additionalProperties":true,"description":"FIRE_WEBHOOK — dispara um POST para uma URL externa."},{"type":"object","properties":{"title":{"type":"string","description":"Título do ticket."},"description":{"type":"string","description":"Descrição do ticket."},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"description":"Prioridade do ticket. Default LOW."},"statusId":{"type":"string","description":"Status inicial. Obtenha o id em `GET /ticket-statuses`. Ausente usa o default."},"assigneeIds":{"type":"array","items":{"type":"string"},"description":"Responsáveis pelo ticket. Obtenha os ids em `GET /user`."},"departmentIds":{"type":"array","items":{"type":"string"},"description":"Setores do ticket. Obtenha os ids em `GET /departments`."},"linkConversation":{"type":"boolean","description":"Vincula a conversa que disparou o evento ao ticket. Default true."}},"required":["title"],"additionalProperties":true,"description":"CREATE_TICKET — abre um ticket."},{"type":"object","properties":{"durationMinutes":{"type":"integer","minimum":0,"maximum":43200,"description":"Minutos até reativar nesta conversa. Ausente ou 0: sem prazo (fica pausada até um evento de retomada). Máximo 43200 (30 dias)."},"resumeOnTemplateSent":{"type":"boolean","description":"Quando true, um template enviado nesta conversa depois da pausa reativa a regra. Default false na API; o builder liga por padrão."}},"additionalProperties":true,"description":"PAUSE_AUTOMATION — pausa esta regra nesta conversa. Outras automações continuam."},{"type":"object","properties":{"fastMessageId":{"type":"string","description":"Resposta rápida a enviar. Obtenha o id em `GET /fast-message?inboxId={inboxId}` — é o campo `id` da lista. Vale para todos os tipos: `TEXT`, `AUDIO`, `IMAGE`, `VIDEO`, `DOCUMENT` e `SEQUENCE` (a sequência sai bloco a bloco, no ritmo salvo). As variáveis `{{Contato.*}}` do texto e da legenda saem com os dados do contato; texto que fica vazio assim não é enviado. Obrigatório quando `templateName` não for enviado."},"templateName":{"type":"string","description":"Nome do template aprovado na API oficial. Liste os disponíveis em `GET /integration/templates/{integrationId}`."},"variables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do corpo do template, na ordem em que aparecem."},"bodyVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do corpo, na mesma ordem de `variables`."},"headerVariables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do cabeçalho do template."},"headerVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do cabeçalho, na mesma ordem de `headerVariables`."},"headerMedia":{"description":"Mídia do cabeçalho: `{ format: IMAGE | VIDEO | DOCUMENT | LOCATION, link, fileName, latitude, longitude, name, address }`."},"buttonVariables":{"description":"Variáveis de botões dinâmicos: `[{ index, parameters: string[], parameterNames?: string[] }]`."},"createConversation":{"type":"boolean","description":"Abre um atendimento no número de WhatsApp quando o contato ainda não tem conversa. Default true. False não envia se não houver conversa."}},"additionalProperties":true,"description":"SEND_FAST_MESSAGE — envia uma resposta rápida na conversa. Informe `fastMessageId` OU `templateName`."},{"type":"object","properties":{"text":{"type":"string","description":"Texto da mensagem. Obrigatório quando `templateName` não for enviado."},"delayMinutes":{"type":"number","description":"Minutos de espera entre o disparo do evento e o envio. Ausente envia na hora."},"sendWindowEnabled":{"type":"boolean","description":"Quando true, o envio é adiado para dentro da janela abaixo."},"sendWindowStart":{"type":"string","description":"Início da janela de envio, `HH:mm` no fuso America/Sao_Paulo."},"sendWindowEnd":{"type":"string","description":"Fim da janela de envio, `HH:mm` no fuso America/Sao_Paulo."},"templateName":{"type":"string","description":"Nome do template aprovado na API oficial. Liste os disponíveis em `GET /integration/templates/{integrationId}`."},"variables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do corpo do template, na ordem em que aparecem."},"bodyVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do corpo, na mesma ordem de `variables`."},"headerVariables":{"type":"array","items":{"type":"string"},"description":"Valores das variáveis do cabeçalho do template."},"headerVariableNames":{"type":"array","items":{"type":"string"},"description":"Nomes das variáveis do cabeçalho, na mesma ordem de `headerVariables`."},"headerMedia":{"description":"Mídia do cabeçalho: `{ format: IMAGE | VIDEO | DOCUMENT | LOCATION, link, fileName, latitude, longitude, name, address }`."},"buttonVariables":{"description":"Variáveis de botões dinâmicos: `[{ index, parameters: string[], parameterNames?: string[] }]`."},"createConversation":{"type":"boolean","description":"Abre um atendimento no número de WhatsApp quando o contato ainda não tem conversa. Default true. False não agenda se não houver conversa."}},"additionalProperties":true,"description":"SCHEDULE_MESSAGE — agenda uma mensagem na conversa. Informe `text` OU `templateName`."},{"type":"object","properties":{"text":{"type":"string","description":"Texto enviado no Direct."},"publicReplyText":{"type":"string","description":"Resposta pública no comentário. Só vale em instagram.comment.received."},"createConversation":{"type":"boolean","description":"Abre um atendimento no JuriChat com quem comentou. Default true. False responde no Instagram sem criar conversa."}},"required":["text"],"additionalProperties":true,"description":"SEND_INSTAGRAM_REPLY — responde no Instagram."},{"type":"object","properties":{"mode":{"type":"string","enum":["template","modal"],"description":"`template` (default): cria a tarefa sozinha a cada entrada na coluna, inclusive por bot, fluxo, IA e migração em lote. `modal`: no Kanban, quem arrastou o card confirma e ajusta antes de enviar; a automação em si não cria nada. Só no Então, e com coluna de origem ou de destino no Quando."},"columnId":{"type":"string","description":"Coluna de tarefas do Juridiq (define quadro e pasta). Obtenha o id em `GET /integration/juridiq/task-boards`."},"title":{"type":"string","description":"Título da tarefa, até 190 caracteres. Aceita {{nome}}, {{telefone}}, {{funil}} e {{coluna}}."},"description":{"type":"string","description":"Descrição da tarefa. Aceita as mesmas variáveis do título."}},"required":["columnId","title"],"additionalProperties":true,"description":"CREATE_JURIDIQ_TASK — cria uma tarefa no Juridiq, prioridade Baixa, com a data de hoje e a pessoa vinculada ao contato. Só com o gatilho crm.lead.moved."},{"type":"object","properties":{"customFieldId":{"type":"string","description":"Campo personalizado do funil. Obtenha o id em `GET /funnel-custom-field?funnelId={funnelId}`."},"value":{"type":"string","description":"Valor gravado no card do lead. `multiselect` separa as opções por vírgula; `date` usa `YYYY-MM-DD`. Vazio limpa o campo."}},"required":["customFieldId","value"],"additionalProperties":true,"description":"UPDATE_CUSTOM_FIELD — preenche um campo personalizado no card do lead, no funil do campo."},{"type":"object","properties":{},"additionalProperties":true,"description":"CLOSE_CONVERSATION — encerra a conversa (como o botão Encerrar do atendente). Sem parâmetros. Roda depois das outras ações da regra."},{"type":"object","additionalProperties":{},"description":"Qualquer outro conjunto de parâmetros."}],"description":"Parâmetros da ação. As chaves dependem do valor de `action` — cada alternativa abaixo é a de uma ação."}},"required":["action","actionParams"],"additionalProperties":false},"maxItems":5,"nullable":true,"description":"Ações do ramo Senão. Null remove o ramo. Se o IF for removido, o Senão é limpo mesmo que este campo ainda venha preenchido."},"priority":{"type":"integer","description":"Prioridade da regra."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID da regra de automação."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"officeId":{"type":"string"},"integrationId":{"type":"string","nullable":true},"name":{"type":"string"},"enabled":{"type":"boolean"},"triggerEvent":{"type":"string"},"conditions":{"type":"object","additionalProperties":{},"nullable":true},"actions":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string"},"actionParams":{"type":"object","additionalProperties":{}}},"required":["action","actionParams"],"additionalProperties":false}},"elseActions":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string"},"actionParams":{"type":"object","additionalProperties":{}}},"required":["action","actionParams"],"additionalProperties":false},"nullable":true},"priority":{"type":"number"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","officeId","integrationId","name","enabled","triggerEvent","conditions","actions","elseActions","priority","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir regra de automação","tags":["Automation Rules"],"description":"Remove permanentemente uma regra de automação.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true,"description":"ID da regra de automação."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"],"nullable":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/homepage-v2/get-attendant-dashboard":{"get":{"summary":"Obter dashboard do atendente","tags":["Home"],"description":"Retorna as métricas do dashboard do atendente.","parameters":[{"schema":{"type":"string","nullable":true},"in":"query","name":"userIdBody","required":false,"description":"ID do atendente. Null para o usuário autenticado."},{"schema":{"type":"string"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox."},{"schema":{"type":"string"},"in":"query","name":"departmentId","required":false,"description":"ID do departamento."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"endDate","required":false,"description":"Data final do período."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"startDate","required":false,"description":"Data inicial do período."},{"schema":{"type":"boolean"},"in":"query","name":"refreshCache","required":false,"description":"Força atualização do cache."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"queryParams":{"type":"object","properties":{"userIdBody":{"type":"string","nullable":true,"description":"ID do atendente. Null para o usuário autenticado."},"inboxId":{"type":"string","description":"ID da inbox."},"departmentId":{"type":"string","description":"ID do departamento."},"endDate":{"type":"string","format":"date-time","description":"Data final do período."},"startDate":{"type":"string","format":"date-time","description":"Data inicial do período."},"refreshCache":{"type":"boolean","description":"Força atualização do cache."}},"required":["inboxId"],"additionalProperties":false},"cacheAt":{"type":"string"},"warning":{"type":"string"},"kpis":{"type":"object","properties":{"awaiting":{"type":"number"},"inProgress":{"type":"number"},"resolved":{"type":"number"}},"required":["awaiting","inProgress","resolved"],"additionalProperties":false},"conversationsAwaitingAttention":{"type":"object","properties":{"count":{"type":"number"},"data":{"type":"array","items":{"type":"object","properties":{"idConversation":{"type":"string"},"namePerson":{"type":"string"},"lastMessage":{"type":"string"},"timeSinceLastMessage":{"type":"number"},"statusColor":{"type":"string","enum":["red","yellow","green"]},"avatarUrl":{"type":"string"},"tagIds":{"type":"array","items":{"type":"string"}}},"required":["idConversation","namePerson","lastMessage","timeSinceLastMessage","statusColor","tagIds"],"additionalProperties":false}}},"required":["count"],"additionalProperties":false},"averageResponseTime":{"type":"object","properties":{"goalInMinutes":{"type":"number"},"timeInMinutes":{"type":"number"},"description":{"type":"string"},"chart":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"valueInMinutes":{"type":"number"}},"required":["date","valueInMinutes"],"additionalProperties":false}}},"required":["goalInMinutes","timeInMinutes","description"],"additionalProperties":false},"averageTimeToResolution":{"type":"object","properties":{"goalInMinutes":{"type":"number"},"timeInMinutes":{"type":"number"},"chart":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"valueInMinutes":{"type":"number"}},"required":["date","valueInMinutes"],"additionalProperties":false}}},"required":["goalInMinutes","timeInMinutes"],"additionalProperties":false},"awaitingClient":{"type":"object","properties":{"count":{"type":"number"},"data":{"type":"array","items":{"type":"object","properties":{"idConversation":{"type":"string"},"namePerson":{"type":"string"},"timeSinceLastMessage":{"type":"number"},"avatarUrl":{"type":"string"},"tagIds":{"type":"array","items":{"type":"string"}}},"required":["idConversation","namePerson","timeSinceLastMessage","tagIds"],"additionalProperties":false}}},"required":["count","data"],"additionalProperties":false},"activityByDay":{"type":"object","properties":{"received":{"type":"number"},"sent":{"type":"number"},"chart":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"received":{"type":"number"},"sent":{"type":"number"}},"required":["date","received","sent"],"additionalProperties":false}}},"required":["received","sent","chart"],"additionalProperties":false},"conversationsByTag":{"type":"object","properties":{"total":{"type":"number"},"untagged":{"type":"number"},"data":{"type":"array","items":{"type":"object","properties":{"tagId":{"type":"string"},"count":{"type":"number"}},"required":["tagId","count"],"additionalProperties":false}}},"required":["total","untagged","data"],"additionalProperties":false}},"required":["queryParams","cacheAt","kpis","averageResponseTime","averageTimeToResolution"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/homepage-v2/get-manager-dashboard":{"get":{"summary":"Obter dashboard do gestor","tags":["Home"],"description":"Retorna as métricas agregadas do dashboard do gestor.","parameters":[{"schema":{"type":"string"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox."},{"schema":{"type":"string"},"in":"query","name":"departmentId","required":false,"description":"ID do departamento."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"startDate","required":true,"description":"Data inicial do período."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"endDate","required":true,"description":"Data final do período."},{"schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"in":"query","name":"userIds","required":false,"description":"IDs dos atendentes para filtrar as métricas."},{"schema":{"type":"boolean"},"in":"query","name":"refreshCache","required":false,"description":"Força atualização do cache."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"queryParams":{"type":"object","properties":{"inboxId":{"type":"string","description":"ID da inbox."},"departmentId":{"type":"string","description":"ID do departamento."},"startDate":{"type":"string","format":"date-time","description":"Data inicial do período."},"endDate":{"type":"string","format":"date-time","description":"Data final do período."},"userIds":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"IDs dos atendentes para filtrar as métricas."},"refreshCache":{"type":"boolean","description":"Força atualização do cache."}},"required":["inboxId","startDate","endDate"],"additionalProperties":false},"cacheAt":{"type":"string"},"kpis":{"type":"object","properties":{"totalLeads":{"type":"number"},"newLeads":{"type":"number"},"closedContracts":{"type":"number"},"processConsultations":{"type":"number"}},"required":["totalLeads","newLeads","closedContracts","processConsultations"],"additionalProperties":false},"leadConversionRate":{"type":"object","properties":{"closed":{"type":"number"},"lost":{"type":"number"},"open":{"type":"number"},"conversionRate":{"type":"number"}},"required":["closed","lost","open","conversionRate"],"additionalProperties":false},"leadsByLegalArea":{"type":"array","items":{"type":"object","properties":{"legalAreaId":{"type":"string","nullable":true},"name":{"type":"string"},"color":{"type":"string"},"count":{"type":"number"}},"required":["legalAreaId","name","color","count"],"additionalProperties":false}},"messagesReceived":{"type":"object","properties":{"total":{"type":"number"},"chart":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"count":{"type":"number"}},"required":["date","count"],"additionalProperties":false}}},"required":["total","chart"],"additionalProperties":false},"tma":{"type":"object","properties":{"goalInMinutes":{"type":"number"},"teamAverage":{"type":"number"},"perUser":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string"},"name":{"type":"string"},"valueInMinutes":{"type":"number"}},"required":["userId","name","valueInMinutes"],"additionalProperties":false}}},"required":["goalInMinutes","teamAverage","perUser"],"additionalProperties":false},"tmr":{"type":"object","properties":{"goalInMinutes":{"type":"number"},"teamAverage":{"type":"number"},"perUser":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string"},"name":{"type":"string"},"valueInMinutes":{"type":"number"}},"required":["userId","name","valueInMinutes"],"additionalProperties":false}}},"required":["goalInMinutes","teamAverage","perUser"],"additionalProperties":false},"humanVsAi":{"type":"object","properties":{"human":{"type":"number"},"ai":{"type":"number"}},"required":["human","ai"],"additionalProperties":false},"aiAgents":{"type":"array","items":{"type":"object","properties":{"agentId":{"type":"string"},"name":{"type":"string"},"totalConversations":{"type":"number"},"resolvedConversations":{"type":"number"}},"required":["agentId","name","totalConversations","resolvedConversations"],"additionalProperties":false}},"teamPerformance":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string"},"name":{"type":"string"},"conversionRate":{"type":"number"},"tmaMinutes":{"type":"number"},"tmrMinutes":{"type":"number"},"totalConversations":{"type":"number"}},"required":["userId","name","conversionRate","tmaMinutes","tmrMinutes","totalConversations"],"additionalProperties":false}}},"required":["queryParams","cacheAt","kpis","leadConversionRate","leadsByLegalArea","messagesReceived","tma","tmr","humanVsAi","aiAgents","teamPerformance"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/homepage-v2/get-clients-map":{"get":{"summary":"Obter mapa de clientes por estado","tags":["Home"],"description":"Distribuição geográfica das conversas da inbox por UF, derivada do DDD do telefone do contato. Não é afetado por filtro de período.","parameters":[{"schema":{"type":"string"},"in":"query","name":"inboxId","required":true,"description":"ID da inbox."},{"schema":{"type":"boolean"},"in":"query","name":"refreshCache","required":false,"description":"Força atualização do cache."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"cacheAt":{"type":"string"},"total":{"type":"number","description":"Conversas com DDD brasileiro identificável."},"states":{"type":"array","items":{"type":"object","properties":{"uf":{"type":"string"},"name":{"type":"string"},"total":{"type":"number"},"ddds":{"type":"array","items":{"type":"object","properties":{"ddd":{"type":"string"},"total":{"type":"number"}},"required":["ddd","total"],"additionalProperties":false}}},"required":["uf","name","total","ddds"],"additionalProperties":false}}},"required":["cacheAt","total","states"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/legal-areas/":{"get":{"summary":"Listar áreas jurídicas","tags":["Legal Areas"],"description":"Lista as áreas jurídicas do escritório.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID da área jurídica."},"name":{"type":"string","description":"Nome da área jurídica."},"color":{"type":"string","description":"Cor da área jurídica."},"officeId":{"type":"string","nullable":true,"description":"ID do escritório. Null se for área padrão."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","color","officeId","createdAt","updatedAt"],"additionalProperties":false}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Criar área jurídica","tags":["Legal Areas"],"description":"Cria uma área jurídica no escritório.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Nome da área jurídica."},"color":{"type":"string","minLength":1,"description":"Cor da área jurídica (hex ou token)."}},"required":["name","color"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID da área jurídica."},"name":{"type":"string","description":"Nome da área jurídica."},"color":{"type":"string","description":"Cor da área jurídica."},"officeId":{"type":"string","nullable":true,"description":"ID do escritório. Null se for área padrão."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","color","officeId","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/legal-areas/{id}":{"patch":{"summary":"Atualizar área jurídica","tags":["Legal Areas"],"description":"Atualiza uma área jurídica existente.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Novo nome da área jurídica."},"color":{"type":"string","minLength":1,"description":"Nova cor da área jurídica."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID da área jurídica."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID da área jurídica."},"name":{"type":"string","description":"Nome da área jurídica."},"color":{"type":"string","description":"Cor da área jurídica."},"officeId":{"type":"string","nullable":true,"description":"ID do escritório. Null se for área padrão."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","color","officeId","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir área jurídica","tags":["Legal Areas"],"description":"Remove uma área jurídica pelo ID.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID da área jurídica."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"],"nullable":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/acquisition-channels/":{"get":{"summary":"Listar canais de aquisição","tags":["Acquisition Channels"],"description":"Lista os canais de aquisição personalizados do escritório, arquivados inclusive. Os padrão (whatsapp, instagram...) não entram.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do canal."},"name":{"type":"string","description":"Nome do canal."},"archivedAt":{"type":"string","format":"date-time","nullable":true,"description":"Quando foi arquivado. Null se ativo."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","archivedAt","createdAt","updatedAt"],"additionalProperties":false}}}}}}},"post":{"summary":"Criar canal de aquisição","tags":["Acquisition Channels"],"description":"Cria um canal de aquisição personalizado no escritório.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80,"description":"Nome do canal. É o texto gravado em `channel` do lead."}},"required":["name"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do canal."},"name":{"type":"string","description":"Nome do canal."},"archivedAt":{"type":"string","format":"date-time","nullable":true,"description":"Quando foi arquivado. Null se ativo."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","archivedAt","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/acquisition-channels/{id}":{"patch":{"summary":"Atualizar canal de aquisição","tags":["Acquisition Channels"],"description":"Renomeia (troca o canal dos leads do escritório que usavam o nome antigo), arquiva ou reativa um canal.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80,"description":"Nome do canal. É o texto gravado em `channel` do lead."},"archived":{"type":"boolean","description":"true arquiva, false reativa. Leads mantêm o canal."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do canal."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do canal."},"name":{"type":"string","description":"Nome do canal."},"archivedAt":{"type":"string","format":"date-time","nullable":true,"description":"Quando foi arquivado. Null se ativo."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","archivedAt","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/departments/":{"get":{"summary":"Listar departamentos","tags":["Departments"],"description":"Lista os departamentos do escritório.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do departamento."},"name":{"type":"string","description":"Nome do departamento."},"officeId":{"type":"string","description":"ID do escritório."},"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do usuário."},"name":{"type":"string","description":"Nome do usuário."},"email":{"type":"string","description":"E-mail do usuário."},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false},"description":"Usuários do departamento."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","officeId","users","createdAt","updatedAt"],"additionalProperties":false}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Criar departamento","tags":["Departments"],"description":"Cria um departamento no escritório.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Nome do departamento."},"userIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"default":[],"description":"IDs dos usuários vinculados ao departamento."}},"required":["name"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do departamento."},"name":{"type":"string","description":"Nome do departamento."},"officeId":{"type":"string","description":"ID do escritório."},"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do usuário."},"name":{"type":"string","description":"Nome do usuário."},"email":{"type":"string","description":"E-mail do usuário."},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false},"description":"Usuários do departamento."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","officeId","users","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/departments/{id}":{"patch":{"summary":"Atualizar departamento","tags":["Departments"],"description":"Atualiza um departamento existente.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Novo nome do departamento."},"userIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs dos usuários vinculados ao departamento."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do departamento."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID do departamento."},"name":{"type":"string","description":"Nome do departamento."},"officeId":{"type":"string","description":"ID do escritório."},"users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do usuário."},"name":{"type":"string","description":"Nome do usuário."},"email":{"type":"string","description":"E-mail do usuário."},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false},"description":"Usuários do departamento."},"createdAt":{"type":"string","format":"date-time","description":"Data e hora de criação."},"updatedAt":{"type":"string","format":"date-time","description":"Data e hora da última atualização."}},"required":["id","name","officeId","users","createdAt","updatedAt"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir departamento","tags":["Departments"],"description":"Remove um departamento pelo ID.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID do departamento."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"],"nullable":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/tickets/":{"get":{"summary":"Listar tickets","tags":["Tickets"],"description":"Lista os tickets do escritório com filtros e paginação.","parameters":[{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"page","required":false,"description":"Número da página."},{"schema":{"anyOf":[{"type":"string"},{"type":"number"}]},"in":"query","name":"limit","required":false,"description":"Quantidade de itens por página."},{"schema":{"type":"string","enum":["open","all"],"default":"open"},"in":"query","name":"status","required":false,"description":"Filtro de status. \"open\" = status com isClosed=false. \"all\" = todos."},{"schema":{"type":"string","minLength":1},"in":"query","name":"statusId","required":false,"description":"Filtra por um status específico (ex.: paginação de coluna do board)."},{"schema":{"anyOf":[{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"}}]},"in":"query","name":"statusIds","required":false,"description":"Filtra por um ou mais status customizados."},{"schema":{"anyOf":[{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"}}]},"in":"query","name":"tagIds","required":false,"description":"Filtra por uma ou mais etiquetas."},{"schema":{"anyOf":[{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"}}]},"in":"query","name":"assigneeIds","required":false,"description":"Filtra por um ou mais responsáveis."},{"schema":{"anyOf":[{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"}}]},"in":"query","name":"departmentIds","required":false,"description":"Filtra por um ou mais setores."},{"schema":{"type":"string"},"in":"query","name":"title","required":false,"description":"Filtra pelo título do ticket."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"conversationId","required":false,"description":"Filtra tickets vinculados a uma conversa."},{"schema":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"in":"query","name":"priority","required":false,"description":"Filtra por prioridade do ticket."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"startedAt","required":false,"description":"Filtra tickets com data inicial a partir desta data."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"endedAt","required":false,"description":"Filtra tickets com data final até esta data."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"assigneeId","required":false,"description":"Obsoleto. Prefira assigneeIds."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"departmentId","required":false,"description":"Obsoleto. Prefira departmentIds."},{"schema":{"type":"string"},"in":"query","name":"search","required":false,"description":"Obsoleto. Prefira title."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"totalResults":{"type":"number","description":"Total de registros encontrados."},"totalPages":{"type":"number","description":"Total de páginas para a quantidade solicitada."},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"officeId":{"type":"string"},"number":{"type":"integer","exclusiveMinimum":0},"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"isClosed":{"type":"boolean"},"index":{"type":"integer"}},"required":["id","name","color","isClosed","index"],"additionalProperties":false},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"conversationId":{"type":"string","nullable":true},"conversation":{"type":"object","properties":{"id":{"type":"string"},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"phoneNumber":{"type":"string","nullable":true}},"required":["id","name","phoneNumber"],"additionalProperties":false,"nullable":true}},"required":["id","person"],"additionalProperties":false,"nullable":true},"createdByUserId":{"type":"string"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false},"isPublic":{"type":"boolean"},"publicToken":{"type":"string","nullable":true},"publicUrl":{"type":"string","nullable":true},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false}},"departments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false}},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fileName":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"url":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"}},"required":["id","fileName","mimeType","sizeBytes","url","createdAt"],"additionalProperties":false}},"updatesCount":{"type":"integer","minimum":0},"lastUpdate":{"type":"object","properties":{"content":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"}},"required":["id","name","email"],"additionalProperties":false,"nullable":true}},"required":["content"],"additionalProperties":false,"nullable":true},"startedAt":{"type":"string","format":"date-time","nullable":true},"endedAt":{"type":"string","format":"date-time","nullable":true},"points":{"type":"integer","minimum":0,"nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","officeId","number","code","title","description","status","priority","conversationId","conversation","createdByUserId","createdBy","isPublic","publicToken","publicUrl","assignees","departments","tags","attachments","updatesCount","lastUpdate","startedAt","endedAt","points","createdAt","updatedAt"],"additionalProperties":false}},"counters":{"type":"object","properties":{"statuses":{"type":"array","items":{"type":"object","properties":{"statusId":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"isClosed":{"type":"boolean"},"count":{"type":"integer","minimum":0}},"required":["statusId","name","color","isClosed","count"],"additionalProperties":false}},"open":{"type":"integer","minimum":0},"all":{"type":"integer","minimum":0}},"required":["statuses","open","all"],"additionalProperties":false}},"required":["totalResults","totalPages","data","counters"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Criar ticket","tags":["Tickets"],"description":"Cria um ticket. Integrações (API key / MCP) devem enviar `application/json`. A UI pode enviar `multipart/form-data` quando houver arquivos.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200,"description":"Título do ticket."},"description":{"type":"string","maxLength":20000,"description":"Descrição do ticket."},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"description":"Prioridade do ticket."},"statusId":{"type":"string","minLength":1,"description":"ID do status inicial."},"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa vinculada, se houver."},"assigneeIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"default":[],"description":"IDs dos responsáveis."},"departmentIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"default":[],"description":"IDs dos departamentos."},"tagIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs das etiquetas."},"startedAt":{"type":"string","format":"date-time","description":"Data inicial do ticket."},"endedAt":{"type":"string","format":"date-time","description":"Data final do ticket."},"points":{"type":"integer","minimum":0,"maximum":9999,"description":"Pontuação do ticket."}},"required":["title","priority","statusId"],"additionalProperties":false}},"multipart/form-data":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200,"description":"Título do ticket."},"description":{"type":"string","maxLength":20000,"description":"Descrição do ticket."},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"description":"Prioridade do ticket."},"statusId":{"type":"string","minLength":1,"description":"ID do status inicial."},"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa vinculada, se houver."},"assigneeIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"default":[],"description":"IDs dos responsáveis."},"departmentIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"default":[],"description":"IDs dos departamentos."},"tagIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs das etiquetas."},"startedAt":{"type":"string","format":"date-time","description":"Data inicial do ticket."},"endedAt":{"type":"string","format":"date-time","description":"Data final do ticket."},"points":{"type":"integer","minimum":0,"maximum":9999,"description":"Pontuação do ticket."}},"required":["title","priority","statusId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"officeId":{"type":"string"},"number":{"type":"integer","exclusiveMinimum":0},"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"isClosed":{"type":"boolean"},"index":{"type":"integer"}},"required":["id","name","color","isClosed","index"],"additionalProperties":false},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"conversationId":{"type":"string","nullable":true},"conversation":{"type":"object","properties":{"id":{"type":"string"},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"phoneNumber":{"type":"string","nullable":true}},"required":["id","name","phoneNumber"],"additionalProperties":false,"nullable":true}},"required":["id","person"],"additionalProperties":false,"nullable":true},"createdByUserId":{"type":"string"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false},"isPublic":{"type":"boolean"},"publicToken":{"type":"string","nullable":true},"publicUrl":{"type":"string","nullable":true},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false}},"departments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false}},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fileName":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"url":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"}},"required":["id","fileName","mimeType","sizeBytes","url","createdAt"],"additionalProperties":false}},"updatesCount":{"type":"integer","minimum":0},"lastUpdate":{"type":"object","properties":{"content":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"}},"required":["id","name","email"],"additionalProperties":false,"nullable":true}},"required":["content"],"additionalProperties":false,"nullable":true},"updates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"visibility":{"type":"string","enum":["PUBLIC","INTERNAL"]},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false,"nullable":true},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fileName":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"url":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"}},"required":["id","fileName","mimeType","sizeBytes","url","createdAt"],"additionalProperties":false}}},"required":["id","content","visibility","createdAt","createdBy","attachments"],"additionalProperties":false}},"activities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["CREATED","STATUS_CHANGED","PRIORITY_CHANGED","TITLE_CHANGED","DESCRIPTION_CHANGED","ASSIGNEES_CHANGED","DEPARTMENTS_CHANGED","TAGS_CHANGED","DATES_CHANGED","POINTS_CHANGED","CONVERSATION_CHANGED","ATTACHMENTS_ADDED","PUBLIC_LINK_ENABLED","PUBLIC_LINK_DISABLED"]},"field":{"type":"string","nullable":true},"fromValue":{"nullable":true},"toValue":{"nullable":true},"metadata":{"nullable":true},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false,"nullable":true}},"required":["id","type","field","createdAt","createdBy"],"additionalProperties":false}},"startedAt":{"type":"string","format":"date-time","nullable":true},"endedAt":{"type":"string","format":"date-time","nullable":true},"points":{"type":"integer","minimum":0,"nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","officeId","number","code","title","description","status","priority","conversationId","conversation","createdByUserId","createdBy","isPublic","publicToken","publicUrl","assignees","departments","tags","attachments","updatesCount","lastUpdate","startedAt","endedAt","points","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/tickets/board":{"get":{"summary":"Obter board de tickets","tags":["Tickets"],"description":"Retorna o board kanban de tickets agrupado por status.","parameters":[{"schema":{"anyOf":[{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"}}]},"in":"query","name":"statusIds","required":false,"description":"Filtra por um ou mais status (exibe só essas colunas)."},{"schema":{"anyOf":[{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"}}]},"in":"query","name":"tagIds","required":false,"description":"Filtra por uma ou mais etiquetas."},{"schema":{"anyOf":[{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"}}]},"in":"query","name":"assigneeIds","required":false,"description":"Filtra por um ou mais responsáveis."},{"schema":{"anyOf":[{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"}}]},"in":"query","name":"departmentIds","required":false,"description":"Filtra por um ou mais setores."},{"schema":{"type":"string"},"in":"query","name":"title","required":false,"description":"Filtra pelo título do ticket."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"conversationId","required":false,"description":"Filtra tickets vinculados a uma conversa."},{"schema":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"in":"query","name":"priority","required":false,"description":"Filtra por prioridade do ticket."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"startedAt","required":false,"description":"Filtra tickets com data inicial a partir desta data."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"endedAt","required":false,"description":"Filtra tickets com data final até esta data."},{"schema":{"type":"integer","minimum":1,"maximum":50},"in":"query","name":"limit","required":false,"description":"Quantidade inicial de tickets por coluna (padrão 20, máx. 50)."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"assigneeId","required":false,"description":"Obsoleto. Prefira assigneeIds."},{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"query","name":"departmentId","required":false,"description":"Obsoleto. Prefira departmentIds."},{"schema":{"type":"string"},"in":"query","name":"search","required":false,"description":"Obsoleto. Prefira title."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"statuses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"isClosed":{"type":"boolean"},"index":{"type":"integer"}},"required":["id","name","color","isClosed","index"],"additionalProperties":false}},"columns":{"type":"object","additionalProperties":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"officeId":{"type":"string"},"number":{"type":"integer","exclusiveMinimum":0},"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"isClosed":{"type":"boolean"},"index":{"type":"integer"}},"required":["id","name","color","isClosed","index"],"additionalProperties":false},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"conversationId":{"type":"string","nullable":true},"conversation":{"type":"object","properties":{"id":{"type":"string"},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"phoneNumber":{"type":"string","nullable":true}},"required":["id","name","phoneNumber"],"additionalProperties":false,"nullable":true}},"required":["id","person"],"additionalProperties":false,"nullable":true},"createdByUserId":{"type":"string"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false},"isPublic":{"type":"boolean"},"publicToken":{"type":"string","nullable":true},"publicUrl":{"type":"string","nullable":true},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false}},"departments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false}},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fileName":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"url":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"}},"required":["id","fileName","mimeType","sizeBytes","url","createdAt"],"additionalProperties":false}},"updatesCount":{"type":"integer","minimum":0},"lastUpdate":{"type":"object","properties":{"content":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"}},"required":["id","name","email"],"additionalProperties":false,"nullable":true}},"required":["content"],"additionalProperties":false,"nullable":true},"startedAt":{"type":"string","format":"date-time","nullable":true},"endedAt":{"type":"string","format":"date-time","nullable":true},"points":{"type":"integer","minimum":0,"nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","officeId","number","code","title","description","status","priority","conversationId","conversation","createdByUserId","createdBy","isPublic","publicToken","publicUrl","assignees","departments","tags","attachments","updatesCount","lastUpdate","startedAt","endedAt","points","createdAt","updatedAt"],"additionalProperties":false}},"totalResults":{"type":"integer","minimum":0},"page":{"type":"integer","exclusiveMinimum":0},"hasMore":{"type":"boolean"}},"required":["data","totalResults","page","hasMore"],"additionalProperties":false}},"limit":{"type":"integer","exclusiveMinimum":0},"counters":{"type":"object","properties":{"statuses":{"type":"array","items":{"type":"object","properties":{"statusId":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"isClosed":{"type":"boolean"},"count":{"type":"integer","minimum":0}},"required":["statusId","name","color","isClosed","count"],"additionalProperties":false}},"open":{"type":"integer","minimum":0},"all":{"type":"integer","minimum":0}},"required":["statuses","open","all"],"additionalProperties":false}},"required":["statuses","columns","limit","counters"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/tickets/suggest-from-conversation":{"post":{"summary":"Sugerir ticket a partir da conversa","tags":["Tickets"],"description":"Analisa o histórico de um dia da conversa com Claude Sonnet 5 e devolve um rascunho de ticket para o atendente revisar. **Não cria o ticket** — a criação continua sendo `POST /tickets`. Consome 10 créditos de IA do escritório, debitados só após a resposta do modelo.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","description":"ID da conversa que será analisada."},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Dia a analisar (AAAA-MM-DD). A janela é de 24h a partir das 00:00 desse dia. Omitido, usa o dia da mensagem mais recente da conversa."}},"required":["conversationId"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","description":"Título sugerido para o ticket."},"description":{"type":"string","description":"Descrição sugerida, em HTML."},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"description":"Prioridade sugerida."},"departmentIds":{"type":"array","items":{"type":"string"},"description":"Setores sugeridos. Só contém IDs existentes e visíveis ao usuário."},"tagIds":{"type":"array","items":{"type":"string"},"description":"Etiquetas sugeridas. Só contém IDs de etiquetas do módulo de tickets."},"analyzedDate":{"type":"string","description":"Dia efetivamente analisado (AAAA-MM-DD)."},"messagesAnalyzed":{"type":"integer","minimum":0,"description":"Quantidade de mensagens usadas como contexto."}},"required":["title","description","priority","departmentIds","tagIds","analyzedDate","messagesAnalyzed"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/tickets/indicators":{"get":{"summary":"Indicadores de tickets","tags":["Tickets"],"description":"Retorna indicadores e séries temporais de tickets no período.","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"startedAt","required":false,"description":"Início do período (filtra por createdAt). Default: 30 dias atrás."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"endedAt","required":false,"description":"Fim do período (filtra por createdAt). Default: hoje."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"period":{"type":"object","properties":{"startedAt":{"type":"string","format":"date-time"},"endedAt":{"type":"string","format":"date-time"}},"required":["startedAt","endedAt"],"additionalProperties":false},"kpis":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"open":{"type":"integer","minimum":0},"closed":{"type":"integer","minimum":0},"createdInPeriod":{"type":"integer","minimum":0},"closedInPeriod":{"type":"integer","minimum":0},"unassigned":{"type":"integer","minimum":0},"withConversation":{"type":"integer","minimum":0},"publicCount":{"type":"integer","minimum":0},"avgCompletionHours":{"type":"number","minimum":0,"nullable":true},"avgPoints":{"type":"number","minimum":0,"nullable":true},"totalPoints":{"type":"number","minimum":0}},"required":["total","open","closed","createdInPeriod","closedInPeriod","unassigned","withConversation","publicCount","avgCompletionHours","avgPoints","totalPoints"],"additionalProperties":false},"byStatus":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"isClosed":{"type":"boolean"},"count":{"type":"integer","minimum":0}},"required":["id","name","color","isClosed","count"],"additionalProperties":false}},"byPriority":{"type":"array","items":{"type":"object","properties":{"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"count":{"type":"integer","minimum":0}},"required":["priority","count"],"additionalProperties":false}},"byAssignee":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string"},"name":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil do responsável. Null se não houver."},"count":{"type":"integer","minimum":0},"closedCount":{"type":"integer","minimum":0},"avgCompletionHours":{"type":"number","minimum":0,"nullable":true},"points":{"type":"number","minimum":0}},"required":["userId","name","imageUrl","count","closedCount","avgCompletionHours","points"],"additionalProperties":false}},"byDepartment":{"type":"array","items":{"type":"object","properties":{"departmentId":{"type":"string","nullable":true},"name":{"type":"string"},"count":{"type":"integer","minimum":0},"closedCount":{"type":"integer","minimum":0},"avgCompletionHours":{"type":"number","minimum":0,"nullable":true}},"required":["departmentId","name","count","closedCount","avgCompletionHours"],"additionalProperties":false}},"series":{"type":"object","properties":{"created":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"count":{"type":"integer","minimum":0}},"required":["date","count"],"additionalProperties":false}},"closed":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"count":{"type":"integer","minimum":0}},"required":["date","count"],"additionalProperties":false}}},"required":["created","closed"],"additionalProperties":false}},"required":["period","kpis","byStatus","byPriority","byAssignee","byDepartment","series"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/tickets/{id}":{"get":{"summary":"Obter ticket","tags":["Tickets"],"description":"Retorna um ticket pelo ID ou código (TKT-0001).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"path","name":"id","required":true,"description":"ID interno do ticket (CUID) ou código compartilhado (TKT-0001)."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"officeId":{"type":"string"},"number":{"type":"integer","exclusiveMinimum":0},"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"isClosed":{"type":"boolean"},"index":{"type":"integer"}},"required":["id","name","color","isClosed","index"],"additionalProperties":false},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"conversationId":{"type":"string","nullable":true},"conversation":{"type":"object","properties":{"id":{"type":"string"},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"phoneNumber":{"type":"string","nullable":true}},"required":["id","name","phoneNumber"],"additionalProperties":false,"nullable":true}},"required":["id","person"],"additionalProperties":false,"nullable":true},"createdByUserId":{"type":"string"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false},"isPublic":{"type":"boolean"},"publicToken":{"type":"string","nullable":true},"publicUrl":{"type":"string","nullable":true},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false}},"departments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false}},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fileName":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"url":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"}},"required":["id","fileName","mimeType","sizeBytes","url","createdAt"],"additionalProperties":false}},"updatesCount":{"type":"integer","minimum":0},"lastUpdate":{"type":"object","properties":{"content":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"}},"required":["id","name","email"],"additionalProperties":false,"nullable":true}},"required":["content"],"additionalProperties":false,"nullable":true},"updates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"visibility":{"type":"string","enum":["PUBLIC","INTERNAL"]},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false,"nullable":true},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fileName":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"url":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"}},"required":["id","fileName","mimeType","sizeBytes","url","createdAt"],"additionalProperties":false}}},"required":["id","content","visibility","createdAt","createdBy","attachments"],"additionalProperties":false}},"activities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["CREATED","STATUS_CHANGED","PRIORITY_CHANGED","TITLE_CHANGED","DESCRIPTION_CHANGED","ASSIGNEES_CHANGED","DEPARTMENTS_CHANGED","TAGS_CHANGED","DATES_CHANGED","POINTS_CHANGED","CONVERSATION_CHANGED","ATTACHMENTS_ADDED","PUBLIC_LINK_ENABLED","PUBLIC_LINK_DISABLED"]},"field":{"type":"string","nullable":true},"fromValue":{"nullable":true},"toValue":{"nullable":true},"metadata":{"nullable":true},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false,"nullable":true}},"required":["id","type","field","createdAt","createdBy"],"additionalProperties":false}},"startedAt":{"type":"string","format":"date-time","nullable":true},"endedAt":{"type":"string","format":"date-time","nullable":true},"points":{"type":"integer","minimum":0,"nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","officeId","number","code","title","description","status","priority","conversationId","conversation","createdByUserId","createdBy","isPublic","publicToken","publicUrl","assignees","departments","tags","attachments","updatesCount","lastUpdate","startedAt","endedAt","points","createdAt","updatedAt"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"patch":{"summary":"Atualizar ticket","tags":["Tickets"],"description":"Atualiza um ticket pelo ID ou código (TKT-0001). Integrações (API key / MCP) devem enviar `application/json`. A UI pode enviar `multipart/form-data` quando houver arquivos.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200,"description":"Título do ticket."},"description":{"type":"string","maxLength":20000,"nullable":true,"description":"Descrição do ticket. Null para limpar."},"statusId":{"type":"string","minLength":1,"description":"ID do novo status."},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"description":"Prioridade do ticket."},"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","nullable":true,"description":"ID da conversa vinculada. Null para desvincular."},"assigneeIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs dos responsáveis."},"departmentIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs dos departamentos."},"tagIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs das etiquetas."},"startedAt":{"type":"string","format":"date-time","nullable":true,"description":"Data inicial do ticket."},"endedAt":{"type":"string","format":"date-time","nullable":true,"description":"Data final do ticket."},"points":{"type":"integer","minimum":0,"maximum":9999,"nullable":true,"description":"Pontuação do ticket."}},"additionalProperties":false}},"multipart/form-data":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200,"description":"Título do ticket."},"description":{"type":"string","maxLength":20000,"nullable":true,"description":"Descrição do ticket. Null para limpar."},"statusId":{"type":"string","minLength":1,"description":"ID do novo status."},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"description":"Prioridade do ticket."},"conversationId":{"type":"string","pattern":"^[cC][^\\s-]{8,}$","nullable":true,"description":"ID da conversa vinculada. Null para desvincular."},"assigneeIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs dos responsáveis."},"departmentIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs dos departamentos."},"tagIds":{"type":"array","items":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"description":"IDs das etiquetas."},"startedAt":{"type":"string","format":"date-time","nullable":true,"description":"Data inicial do ticket."},"endedAt":{"type":"string","format":"date-time","nullable":true,"description":"Data final do ticket."},"points":{"type":"integer","minimum":0,"maximum":9999,"nullable":true,"description":"Pontuação do ticket."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"path","name":"id","required":true,"description":"ID interno do ticket (CUID) ou código compartilhado (TKT-0001)."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"officeId":{"type":"string"},"number":{"type":"integer","exclusiveMinimum":0},"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"isClosed":{"type":"boolean"},"index":{"type":"integer"}},"required":["id","name","color","isClosed","index"],"additionalProperties":false},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"conversationId":{"type":"string","nullable":true},"conversation":{"type":"object","properties":{"id":{"type":"string"},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"phoneNumber":{"type":"string","nullable":true}},"required":["id","name","phoneNumber"],"additionalProperties":false,"nullable":true}},"required":["id","person"],"additionalProperties":false,"nullable":true},"createdByUserId":{"type":"string"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false},"isPublic":{"type":"boolean"},"publicToken":{"type":"string","nullable":true},"publicUrl":{"type":"string","nullable":true},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false}},"departments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false}},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fileName":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"url":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"}},"required":["id","fileName","mimeType","sizeBytes","url","createdAt"],"additionalProperties":false}},"updatesCount":{"type":"integer","minimum":0},"lastUpdate":{"type":"object","properties":{"content":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"}},"required":["id","name","email"],"additionalProperties":false,"nullable":true}},"required":["content"],"additionalProperties":false,"nullable":true},"updates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"visibility":{"type":"string","enum":["PUBLIC","INTERNAL"]},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false,"nullable":true},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fileName":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"url":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"}},"required":["id","fileName","mimeType","sizeBytes","url","createdAt"],"additionalProperties":false}}},"required":["id","content","visibility","createdAt","createdBy","attachments"],"additionalProperties":false}},"activities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["CREATED","STATUS_CHANGED","PRIORITY_CHANGED","TITLE_CHANGED","DESCRIPTION_CHANGED","ASSIGNEES_CHANGED","DEPARTMENTS_CHANGED","TAGS_CHANGED","DATES_CHANGED","POINTS_CHANGED","CONVERSATION_CHANGED","ATTACHMENTS_ADDED","PUBLIC_LINK_ENABLED","PUBLIC_LINK_DISABLED"]},"field":{"type":"string","nullable":true},"fromValue":{"nullable":true},"toValue":{"nullable":true},"metadata":{"nullable":true},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false,"nullable":true}},"required":["id","type","field","createdAt","createdBy"],"additionalProperties":false}},"startedAt":{"type":"string","format":"date-time","nullable":true},"endedAt":{"type":"string","format":"date-time","nullable":true},"points":{"type":"integer","minimum":0,"nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","officeId","number","code","title","description","status","priority","conversationId","conversation","createdByUserId","createdBy","isPublic","publicToken","publicUrl","assignees","departments","tags","attachments","updatesCount","lastUpdate","startedAt","endedAt","points","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir ticket","tags":["Tickets"],"description":"Remove um ticket pelo ID ou código (TKT-0001).","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"path","name":"id","required":true,"description":"ID interno do ticket (CUID) ou código compartilhado (TKT-0001)."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/tickets/{id}/updates":{"post":{"summary":"Adicionar atualização ao ticket","tags":["Tickets"],"description":"Adiciona um comentário ou anexo ao ticket. Integrações (API key / MCP) devem enviar `application/json` com `content`. A UI pode enviar `multipart/form-data` quando houver arquivos.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","maxLength":20000,"default":"","description":"Texto da atualização. Obrigatório se não houver arquivo."},"visibility":{"type":"string","enum":["PUBLIC","INTERNAL"],"default":"PUBLIC","description":"Visibilidade da atualização: PUBLIC ou INTERNAL."}},"additionalProperties":false}},"multipart/form-data":{"schema":{"type":"object","properties":{"content":{"type":"string","maxLength":20000,"default":"","description":"Texto da atualização. Obrigatório se não houver arquivo."},"visibility":{"type":"string","enum":["PUBLIC","INTERNAL"],"default":"PUBLIC","description":"Visibilidade da atualização: PUBLIC ou INTERNAL."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"path","name":"id","required":true,"description":"ID interno do ticket (CUID) ou código compartilhado (TKT-0001)."}],"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"officeId":{"type":"string"},"number":{"type":"integer","exclusiveMinimum":0},"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","nullable":true},"status":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"isClosed":{"type":"boolean"},"index":{"type":"integer"}},"required":["id","name","color","isClosed","index"],"additionalProperties":false},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"conversationId":{"type":"string","nullable":true},"conversation":{"type":"object","properties":{"id":{"type":"string"},"person":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true},"phoneNumber":{"type":"string","nullable":true}},"required":["id","name","phoneNumber"],"additionalProperties":false,"nullable":true}},"required":["id","person"],"additionalProperties":false,"nullable":true},"createdByUserId":{"type":"string"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false},"isPublic":{"type":"boolean"},"publicToken":{"type":"string","nullable":true},"publicUrl":{"type":"string","nullable":true},"assignees":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false}},"departments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}},"tags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"}},"required":["id","name","color"],"additionalProperties":false}},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fileName":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"url":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"}},"required":["id","fileName","mimeType","sizeBytes","url","createdAt"],"additionalProperties":false}},"updatesCount":{"type":"integer","minimum":0},"lastUpdate":{"type":"object","properties":{"content":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"}},"required":["id","name","email"],"additionalProperties":false,"nullable":true}},"required":["content"],"additionalProperties":false,"nullable":true},"updates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"content":{"type":"string"},"visibility":{"type":"string","enum":["PUBLIC","INTERNAL"]},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false,"nullable":true},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fileName":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"type":"integer","minimum":0},"url":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"}},"required":["id","fileName","mimeType","sizeBytes","url","createdAt"],"additionalProperties":false}}},"required":["id","content","visibility","createdAt","createdBy","attachments"],"additionalProperties":false}},"activities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["CREATED","STATUS_CHANGED","PRIORITY_CHANGED","TITLE_CHANGED","DESCRIPTION_CHANGED","ASSIGNEES_CHANGED","DEPARTMENTS_CHANGED","TAGS_CHANGED","DATES_CHANGED","POINTS_CHANGED","CONVERSATION_CHANGED","ATTACHMENTS_ADDED","PUBLIC_LINK_ENABLED","PUBLIC_LINK_DISABLED"]},"field":{"type":"string","nullable":true},"fromValue":{"nullable":true},"toValue":{"nullable":true},"metadata":{"nullable":true},"createdAt":{"type":"string","format":"date-time"},"createdBy":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"imageUrl":{"type":"string","nullable":true,"description":"Foto de perfil. Null se não houver."}},"required":["id","name","email","imageUrl"],"additionalProperties":false,"nullable":true}},"required":["id","type","field","createdAt","createdBy"],"additionalProperties":false}},"startedAt":{"type":"string","format":"date-time","nullable":true},"endedAt":{"type":"string","format":"date-time","nullable":true},"points":{"type":"integer","minimum":0,"nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","officeId","number","code","title","description","status","priority","conversationId","conversation","createdByUserId","createdBy","isPublic","publicToken","publicUrl","assignees","departments","tags","attachments","updatesCount","lastUpdate","startedAt","endedAt","points","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/ticket-statuses/":{"get":{"summary":"Listar status de tickets","tags":["Ticket Statuses"],"description":"Lista os status de tickets do escritório.","security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"officeId":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"index":{"type":"integer"},"isClosed":{"type":"boolean"},"isDefault":{"type":"boolean"},"key":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","officeId","name","color","index","isClosed","isDefault","key","createdAt","updatedAt"],"additionalProperties":false}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"post":{"summary":"Criar status de ticket","tags":["Ticket Statuses"],"description":"Cria um status personalizado para tickets do escritório.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80,"description":"Nome do status."},"color":{"type":"string","minLength":1,"maxLength":32,"description":"Cor do status."},"isClosed":{"type":"boolean","default":false,"description":"Indica se tickets neste status estão encerrados."},"isDefault":{"type":"boolean","default":false,"description":"Indica se este é o status padrão de novos tickets."}},"required":["name","color"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"officeId":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"index":{"type":"integer"},"isClosed":{"type":"boolean"},"isDefault":{"type":"boolean"},"key":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","officeId","name","color","index","isClosed","isDefault","key","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/ticket-statuses/reorder":{"put":{"summary":"Reordenar status de tickets","tags":["Ticket Statuses"],"description":"Define a ordem dos status no board de tickets.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"orderedIds":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"description":"IDs dos status na nova ordem do board."}},"required":["orderedIds"],"additionalProperties":false}}},"required":true},"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"officeId":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"index":{"type":"integer"},"isClosed":{"type":"boolean"},"isDefault":{"type":"boolean"},"key":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","officeId","name","color","index","isClosed","isDefault","key","createdAt","updatedAt"],"additionalProperties":false}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/ticket-statuses/{id}":{"patch":{"summary":"Atualizar status de ticket","tags":["Ticket Statuses"],"description":"Atualiza um status de ticket existente.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80,"description":"Nome do status."},"color":{"type":"string","minLength":1,"maxLength":32,"description":"Cor do status."},"isClosed":{"type":"boolean","description":"Indica se tickets neste status estão encerrados."},"isDefault":{"type":"boolean","description":"Indica se este é o status padrão de novos tickets."},"index":{"type":"integer","minimum":0,"description":"Posição do status no board."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true,"description":"ID do status."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"officeId":{"type":"string"},"name":{"type":"string"},"color":{"type":"string"},"index":{"type":"integer"},"isClosed":{"type":"boolean"},"isDefault":{"type":"boolean"},"key":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","officeId","name","color","index","isClosed","isDefault","key","createdAt","updatedAt"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}},"delete":{"summary":"Excluir status de ticket","tags":["Ticket Statuses"],"description":"Remove um status de ticket pelo ID.","parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"id","required":true,"description":"ID do status."}],"security":[{"apiKeyAuth":[]}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"],"nullable":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}},"/ia-process/resume-audio-message/{id}":{"get":{"summary":"Transcrever e resumir áudio da conversa","tags":["Ia Process"],"description":"Transcreve uma mensagem `audio` ou `myaudio` e devolve transcrição + resumo HTML. Se já existir no metadata, reutiliza sem novo débito. Requer créditos de IA quando processa de fato.","parameters":[{"schema":{"type":"string","pattern":"^[cC][^\\s-]{8,}$"},"in":"path","name":"id","required":true,"description":"ID interno da mensagem de áudio (cuid)."}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"transcription":{"type":"string","description":"Texto transcrito do áudio (Whisper)."},"summary":{"type":"string","description":"Resumo em HTML do áudio, gerado a partir da transcrição."}},"required":["transcription","summary"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"statusCode":{"type":"number"},"code":{"type":"string"},"details":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"object","properties":{},"additionalProperties":true}],"description":"Detalhes adicionais do erro."}},"required":["message","statusCode"],"additionalProperties":false}}}}}}}},"servers":[{"url":"https://api.jurichat.com","description":"Production server"}],"security":[{"apiKeyAuth":[]}],"tags":[]}