{"openapi":"3.1.0","info":{"title":"Vértice API","version":"0.2.0","description":"API REST multi-tenant do Vértice para WhatsApp: instâncias, mensagens, fila durável, grupos, webhooks e faturamento. Autentique com cookie de sessão (painel) ou API key do workspace.","contact":{"email":"suporte@vertice.app"}},"servers":[{"url":"/","description":"Mesma origem"}],"tags":[{"name":"Público"},{"name":"Autenticação"},{"name":"Workspace"},{"name":"Instâncias"},{"name":"Configurações"},{"name":"Privacidade"},{"name":"Contatos"},{"name":"Mensagens"},{"name":"Fila"},{"name":"Grupos"},{"name":"Comunidades"},{"name":"Canais"},{"name":"Conversas"},{"name":"Ligações"},{"name":"WhatsApp Business"},{"name":"Status"},{"name":"Campanhas"},{"name":"Webhooks"},{"name":"MCP"},{"name":"Faturamento"},{"name":"Admin"},{"name":"Compatibilidade"},{"name":"Parceiros"},{"name":"Mobile"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Chave do workspace (`vtc_live_...`)"},"BearerAuth":{"type":"http","scheme":"bearer","description":"A mesma API key no header Authorization"},"SessionCookie":{"type":"apiKey","in":"cookie","name":"vertice_session","description":"Sessão do painel; mutações exigem x-csrf-token"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"BadRequest":{"description":"Requisição inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Não autenticado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/health":{"get":{"tags":["Público"],"summary":"Status da API e do Postgres","description":"Retorna o status do processo e do Postgres. Não exige autenticação.","operationId":"gethealth","security":[],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/public/plans":{"get":{"tags":["Público"],"summary":"Planos e preços públicos","description":"Lista os planos públicos, preços e limites usados na landing e no checkout.","operationId":"getpublic_plans","security":[],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/public/config":{"get":{"tags":["Público"],"summary":"Configuração pública (cadastro/Stripe)","description":"Expõe apenas configuração pública: cadastro habilitado e Stripe configurado.","operationId":"getpublic_config","security":[],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/openapi.json":{"get":{"tags":["Público"],"summary":"Especificação OpenAPI 3.1","description":"Serve a especificação OpenAPI 3.1 completa da API.","operationId":"getopenapi_json","security":[],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/docs/vertice.postman_collection.json":{"get":{"tags":["Público"],"summary":"Coleção Postman para importar","description":"Serve a coleção Postman v2.1 gerada a partir do catálogo de rotas.","operationId":"getdocs_vertice_postman_collection_json","security":[],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/auth/signup":{"post":{"tags":["Autenticação"],"summary":"Cria workspace e conta proprietária","description":"Cria um workspace isolado, a conta proprietária e a sessão inicial. O primeiro cadastro da instalação pode adotar instâncias órfãs de versões antigas.","operationId":"postauth_signup","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"workspace":"Nimbus Labs","name":"Isaias Silva","email":"voce@empresa.com","password":"uma-senha-forte"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/auth/login":{"post":{"tags":["Autenticação"],"summary":"Login por e-mail e senha","description":"Autentica e-mail e senha. Se o 2FA estiver ativo, a resposta não cria sessão: devolve um desafio de 5 minutos para confirmar o código.","operationId":"postauth_login","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"email":"voce@empresa.com","password":"uma-senha-forte"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/auth/logout":{"post":{"tags":["Autenticação"],"summary":"Encerra a sessão e limpa cookies","description":"Encerra a sessão atual, remove o registro do banco e limpa os cookies de sessão e CSRF.","operationId":"postauth_logout","security":[],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/auth/me":{"get":{"tags":["Autenticação"],"summary":"Usuário, workspace, limites e uso","description":"Retorna o usuário autenticado, o workspace, os limites do plano, o uso atual e se o 2FA está ativo.","operationId":"getauth_me","security":[{"SessionCookie":[]}],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/auth/2fa/setup":{"post":{"tags":["Autenticação"],"summary":"Gera segredo TOTP e QR code","description":"Gera um segredo TOTP novo e devolve o QR code e a URL otpauth para configurar o app autenticador. Só funciona antes de ativar o 2FA.","operationId":"postauth_2fa_setup","security":[{"SessionCookie":[]}],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/auth/2fa/enable":{"post":{"tags":["Autenticação"],"summary":"Confirma código e ativa 2FA","description":"Confere o código do app autenticador e ativa o 2FA. Devolve oito códigos de recuperação de uso único, exibidos apenas uma vez.","operationId":"postauth_2fa_enable","security":[{"SessionCookie":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"code":"123456"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/auth/2fa/verify":{"post":{"tags":["Autenticação"],"summary":"Troca desafio + código por sessão","description":"Troca o desafio emitido pelo login por uma sessão válida. Aceita o código TOTP atual ou um código de recuperação ainda não utilizado.","operationId":"postauth_2fa_verify","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"challengeToken":"...","code":"123456"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/auth/2fa/disable":{"post":{"tags":["Autenticação"],"summary":"Desativa 2FA com a senha atual","description":"Desativa o 2FA do usuário após confirmar a senha atual. O segredo e os códigos de recuperação são apagados.","operationId":"postauth_2fa_disable","security":[{"SessionCookie":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"password":"..."}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/auth/2fa/recovery-codes":{"post":{"tags":["Autenticação"],"summary":"Regenera códigos de recuperação","description":"Gera um novo conjunto de códigos de recuperação e invalida os anteriores. Exige a senha atual e o 2FA ativo.","operationId":"postauth_2fa_recovery_codes","security":[{"SessionCookie":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"password":"..."}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/auth/profile":{"patch":{"tags":["Autenticação"],"summary":"Atualiza o nome do usuário","description":"Atualiza o nome exibido do usuário autenticado.","operationId":"patchauth_profile","security":[{"SessionCookie":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"Novo nome"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/auth/password":{"post":{"tags":["Autenticação"],"summary":"Troca a senha e encerra outras sessões","description":"Troca a senha após confirmar a senha atual e encerra as outras sessões do usuário.","operationId":"postauth_password","security":[{"SessionCookie":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"currentPassword":"...","newPassword":"..."}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/invitations/{token}":{"get":{"tags":["Autenticação"],"summary":"Informações públicas de um convite","description":"Retorna informações públicas de um convite válido.","operationId":"getinvitations_token","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/invitations/{token}/accept":{"post":{"tags":["Autenticação"],"summary":"Aceita convite e cria a conta","description":"Aceita o convite, cria a conta com o papel definido e inicia a sessão.","operationId":"postinvitations_token_accept","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"Pessoa","password":"uma-senha-forte"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/tenant":{"get":{"tags":["Workspace"],"summary":"Workspace, limites e uso","description":"Retorna o workspace, plano, limites, uso de números e membros e a assinatura quando existir.","operationId":"gettenant","security":[{"SessionCookie":[]}],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"patch":{"tags":["Workspace"],"summary":"Renomeia o workspace (admin)","description":"Renomeia o workspace. Exige papel de administrador ou proprietário.","operationId":"patchtenant","security":[{"SessionCookie":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"Novo nome"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/tenant/members":{"get":{"tags":["Workspace"],"summary":"Equipe e convites pendentes","description":"Lista os membros ativos e os convites pendentes do workspace.","operationId":"gettenant_members","security":[{"SessionCookie":[]}],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/tenant/invitations":{"post":{"tags":["Workspace"],"summary":"Cria convite por link","description":"Cria um convite por link para entrar no workspace. Não há envio de e-mail nesta versão; o link é retornado para o admin compartilhar.","operationId":"posttenant_invitations","security":[{"SessionCookie":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"email":"pessoa@empresa.com","role":"member"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/tenant/invitations/{id}/resend":{"post":{"tags":["Workspace"],"summary":"Gera novo link para o convite","description":"Gera um novo token e link para um convite pendente, invalidando o link anterior.","operationId":"posttenant_invitations_id_resend","security":[{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/tenant/invitations/{id}":{"delete":{"tags":["Workspace"],"summary":"Revoga um convite","description":"Revoga um convite pendente.","operationId":"deletetenant_invitations_id","security":[{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/tenant/members/{id}":{"patch":{"tags":["Workspace"],"summary":"Altera papel do membro (owner)","description":"Altera o papel de um membro entre member, admin e owner. Apenas o proprietário pode executar.","operationId":"patchtenant_members_id","security":[{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"role":"admin"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Workspace"],"summary":"Remove um membro","description":"Remove um membro do workspace e revoga as sessões daquela pessoa.","operationId":"deletetenant_members_id","security":[{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/tenant/api-keys":{"get":{"tags":["Workspace"],"summary":"Lista chaves de API ativas","description":"Lista as chaves de API ativas do workspace, sem revelar o segredo.","operationId":"gettenant_api_keys","security":[{"SessionCookie":[]}],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["Workspace"],"summary":"Cria chave de API (mostrada uma vez)","description":"Cria uma chave de API com escopos e allowlist de IP opcional. O valor completo é retornado uma única vez.","operationId":"posttenant_api_keys","security":[{"SessionCookie":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"Integração CRM","scopes":["read","write"],"allowedIps":[]}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/tenant/api-keys/{id}":{"delete":{"tags":["Workspace"],"summary":"Revoga uma chave de API","description":"Revoga imediatamente uma chave de API do workspace.","operationId":"deletetenant_api_keys_id","security":[{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/tenant/audit":{"get":{"tags":["Workspace"],"summary":"Trilha de auditoria do workspace","description":"Retorna as últimas ações administrativas do workspace: login, convites, chaves, instâncias, planos e alterações de configuração.","operationId":"gettenant_audit","security":[{"SessionCookie":[]}],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/metrics/overview":{"get":{"tags":["Workspace"],"summary":"Métricas agregadas do painel","description":"Agrega instâncias por status, mensagens dos últimos sete dias, mensagens enviadas no mês, saúde dos webhooks e uso do plano.","operationId":"getmetrics_overview","security":[{"SessionCookie":[]}],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances":{"get":{"tags":["Instâncias"],"summary":"Lista instâncias do workspace","description":"Lista os números do workspace com status, telefone, webhook e filtros configurados. Com a chave mestra, pode listar todas as instâncias.","operationId":"getinstances","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["Instâncias"],"summary":"Cria uma instância","description":"Cria uma instância e retorna o segredo HMAC do webhook. Guarde o segredo agora: ele não aparece novamente em claro.","operationId":"postinstances","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"Atendimento","webhookUrl":"https://seu-sistema.com/hooks/whatsapp"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}":{"get":{"tags":["Instâncias"],"summary":"Detalhe da instância","description":"Retorna o detalhe de uma instância e sua configuração atual.","operationId":"getinstances_id","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"patch":{"tags":["Instâncias"],"summary":"Edita nome, webhook e filtros","description":"Edita nome, URL de webhook, eventos assinados e a opção de incluir mensagens enviadas por você. A URL passa por validação SSRF.","operationId":"patchinstances_id","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"Comercial","webhookEvents":["message.received","message.sent"],"webhookNotifyFromMe":false}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Instâncias"],"summary":"Remove a instância e a sessão","description":"Remove a instância, encerra o socket, apaga a sessão Baileys e descarta o histórico local.","operationId":"deleteinstances_id","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/webhook-secret":{"get":{"tags":["Instâncias"],"summary":"Revela o segredo HMAC (admin)","description":"Revela o segredo HMAC da instância para validar assinaturas. Restrito a administradores quando autenticado por sessão.","operationId":"getinstances_id_webhook_secret","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/connect-link":{"post":{"tags":["Instâncias"],"summary":"Gera link/iframe temporário de conexão","description":"Gera um link HMAC de 15 minutos para uma página pública de conexão, além do trecho de iframe para incorporar em sites de clientes.","operationId":"postinstances_id_connect_link","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/connect":{"post":{"tags":["Instâncias"],"summary":"Abre o socket (QR ou sessão salva)","description":"Abre o socket da instância. Se houver sessão salva, reconecta sem QR; caso contrário, gera um novo QR code.","operationId":"postinstances_id_connect","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/disconnect":{"post":{"tags":["Instâncias"],"summary":"Desconecta mantendo a sessão","description":"Fecha o socket mantendo as credenciais salvas. Um próximo connect reconecta sem novo QR.","operationId":"postinstances_id_disconnect","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/logout":{"post":{"tags":["Instâncias"],"summary":"Desvincula o aparelho e apaga a sessão","description":"Desvincula o aparelho no WhatsApp e apaga a sessão local. É necessário escanear um novo QR para voltar.","operationId":"postinstances_id_logout","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/qr":{"get":{"tags":["Instâncias"],"summary":"Status e QR code atual","description":"Retorna o status atual e, quando a instância aguarda conexão, o QR code em data URL pronta para exibir.","operationId":"getinstances_id_qr","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/pair":{"post":{"tags":["Instâncias"],"summary":"Pareamento por código","description":"Solicita um código de pareamento por telefone para conectar sem câmera. O código é usado no WhatsApp em Aparelhos conectados.","operationId":"postinstances_id_pair","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"phoneNumber":"5511999999999"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/on-whatsapp":{"post":{"tags":["Instâncias"],"summary":"Verifica números no WhatsApp","description":"Verifica até 50 números e informa quais possuem conta no WhatsApp.","operationId":"postinstances_id_on_whatsapp","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"numbers":["5511999999999"]}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages":{"post":{"tags":["Mensagens"],"summary":"Envia texto (síncrono ou fila)","description":"Envia texto para um contato ou grupo. Com queue, delayMessage, delayTyping ou idempotencyKey, o envio passa pela fila durável e responde 202.","operationId":"postinstances_id_messages","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"to":"5511999999999","text":"Olá!","replyTo":"opcional","queue":false,"delayMessage":3,"delayTyping":2,"idempotencyKey":"pedido-123"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/media":{"post":{"tags":["Mensagens"],"summary":"Envia imagem, vídeo, áudio ou documento","description":"Envia imagem, vídeo, áudio ou documento por URL HTTPS ou base64. No envio pela fila, informe a mídia por URL.","operationId":"postinstances_id_media","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"to":"5511999999999","kind":"image","url":"https://bucket.supabase.co/...","caption":"Legenda","ptt":false}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/media/{messageId}":{"get":{"tags":["Mensagens"],"summary":"Baixa mídia recebida (cache)","description":"Baixa a mídia recebida que ainda está no cache local da instância, com content-type seguro e disposição inline quando possível.","operationId":"getinstances_id_media_messageId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/{messageId}/reaction":{"post":{"tags":["Mensagens"],"summary":"Reage a uma mensagem","description":"Adiciona uma reação de emoji a uma mensagem recente. Informe jid quando a mensagem não estiver mais no cache.","operationId":"postinstances_id_messages_messageId_reaction","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"emoji":"👍","jid":"opcional"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Mensagens"],"summary":"Remove a reação","description":"Remove a reação atual de uma mensagem.","operationId":"deleteinstances_id_messages_messageId_reaction","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/{messageId}":{"patch":{"tags":["Mensagens"],"summary":"Edita o texto de uma mensagem","description":"Edita o texto de uma mensagem enviada por você. Informe jid se a mensagem não estiver no cache.","operationId":"patchinstances_id_messages_messageId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"text":"Novo texto","jid":"opcional"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Mensagens"],"summary":"Apaga uma mensagem para todos","description":"Apaga uma mensagem para todos. A operação depende das permissões da conta no WhatsApp.","operationId":"deleteinstances_id_messages_messageId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/{messageId}/forward":{"post":{"tags":["Mensagens"],"summary":"Reencaminha uma mensagem","description":"Reencaminha uma mensagem recente para outro contato ou grupo.","operationId":"postinstances_id_messages_messageId_forward","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"messageId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"to":"5511888888888"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/poll":{"post":{"tags":["Mensagens"],"summary":"Envia uma enquete","description":"Envia uma enquete com 2 a 12 opções e define quantas podem ser selecionadas.","operationId":"postinstances_id_messages_poll","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"to":"5511999999999","name":"Qual o melhor horário?","options":["Manhã","Tarde"],"selectableCount":1}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/location":{"post":{"tags":["Mensagens"],"summary":"Envia uma localização","description":"Envia uma localização com latitude, longitude, nome e endereço opcionais.","operationId":"postinstances_id_messages_location","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"to":"5511999999999","latitude":-23.55,"longitude":-46.63,"name":"Escritório"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/contact":{"post":{"tags":["Mensagens"],"summary":"Envia um contato (vCard)","description":"Envia um contato em formato vCard com nome, telefone e organização opcional.","operationId":"postinstances_id_messages_contact","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"to":"5511999999999","name":"Fulano","phone":"5511888888888"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/sticker":{"post":{"tags":["Mensagens"],"summary":"Envia uma figurinha","description":"Envia uma figurinha a partir de uma URL HTTPS ou base64. O arquivo precisa ser compatível com o WhatsApp.","operationId":"postinstances_id_messages_sticker","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"to":"5511999999999","url":"https://.../sticker.webp"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/read":{"post":{"tags":["Mensagens"],"summary":"Marca mensagens como lidas","description":"Marca mensagens de uma conversa como lidas. Sem ids, usa as mensagens recebidas mais recentes do histórico local.","operationId":"postinstances_id_chats_read","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"jid":"5511999999999@s.whatsapp.net","ids":["opcional"]}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/presence":{"post":{"tags":["Mensagens"],"summary":"Atualiza presença (digitando…)","description":"Atualiza a presença do número: digitando, pausado, disponível ou indisponível.","operationId":"postinstances_id_presence","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"jid":"5511999999999@s.whatsapp.net","state":"composing"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/queue":{"get":{"tags":["Fila"],"summary":"Lista jobs da fila","description":"Lista os jobs da fila da instância e permite filtrar por status: queued, sending, sent, delivered, read, failed ou canceled.","operationId":"getinstances_id_queue","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"status=queued|sending|sent|delivered|read|failed|canceled"}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Fila"],"summary":"Limpa todos os jobs pendentes","description":"Remove todos os jobs pendentes da instância.","operationId":"deleteinstances_id_queue","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/queue/{jobId}":{"get":{"tags":["Fila"],"summary":"Detalhe de um job","description":"Retorna o detalhe de um job da fila.","operationId":"getinstances_id_queue_jobId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Fila"],"summary":"Cancela um job pendente","description":"Cancela um job que ainda está pendente. Jobs já enviados não são afetados.","operationId":"deleteinstances_id_queue_jobId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/groups":{"get":{"tags":["Grupos"],"summary":"Lista grupos da instância","description":"Lista os grupos dos quais o número participa, com tamanho, dono e configurações.","operationId":"getinstances_id_groups","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["Grupos"],"summary":"Cria um grupo","description":"Cria um grupo com nome e lista inicial de participantes.","operationId":"postinstances_id_groups","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"subject":"Time Comercial","participants":["5511999999999"]}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/groups/{jid}":{"get":{"tags":["Grupos"],"summary":"Metadados e participantes do grupo","description":"Retorna nome, descrição, configurações, admins e todos os participantes do grupo.","operationId":"getinstances_id_groups_jid","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"patch":{"tags":["Grupos"],"summary":"Atualiza nome e descrição","description":"Atualiza o nome e/ou a descrição de um grupo.","operationId":"patchinstances_id_groups_jid","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"subject":"Novo nome","description":"Nova descrição"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/groups/{jid}/participants":{"post":{"tags":["Grupos"],"summary":"Adiciona/remove/promove/rebaixa participantes","description":"Adiciona, remove, promove ou rebaixa participantes do grupo em uma única chamada.","operationId":"postinstances_id_groups_jid_participants","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"participants":["5511888888888"],"action":"add"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/groups/{jid}/picture":{"put":{"tags":["Grupos"],"summary":"Atualiza a foto do grupo","description":"Atualiza a foto do grupo.","operationId":"putinstances_id_groups_jid_picture","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"url":"https://.../grupo.jpg"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Grupos"],"summary":"Remove a foto do grupo","description":"Remove a foto do grupo.","operationId":"deleteinstances_id_groups_jid_picture","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/groups/{jid}/requests":{"get":{"tags":["Grupos"],"summary":"Lista solicitações de entrada","description":"Lista solicitações de entrada.","operationId":"getinstances_id_groups_jid_requests","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["Grupos"],"summary":"Aprova/rejeita solicitações de entrada","description":"Aprova/rejeita solicitações de entrada.","operationId":"postinstances_id_groups_jid_requests","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"participants":["5511888888888"],"action":"approve"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/groups/{jid}/ephemeral":{"post":{"tags":["Grupos"],"summary":"Define mensagens temporárias do grupo","description":"Define mensagens temporárias do grupo.","operationId":"postinstances_id_groups_jid_ephemeral","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"seconds":86400}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/groups/{jid}/invite":{"get":{"tags":["Grupos"],"summary":"Consulta o link de convite","description":"Retorna o código e o link de convite atual do grupo.","operationId":"getinstances_id_groups_jid_invite","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/groups/{jid}/invite/revoke":{"post":{"tags":["Grupos"],"summary":"Revoga e gera um novo link","description":"Revoga o link atual e gera um novo código de convite.","operationId":"postinstances_id_groups_jid_invite_revoke","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/groups/join":{"post":{"tags":["Grupos"],"summary":"Entra em um grupo por código","description":"Entra em um grupo a partir do código de convite.","operationId":"postinstances_id_groups_join","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"code":"ABC123"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/groups/invite/{code}":{"get":{"tags":["Grupos"],"summary":"Metadados de um convite","description":"Consulta os metadados públicos de um convite de grupo antes de entrar.","operationId":"getinstances_id_groups_invite_code","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/groups/{jid}/leave":{"post":{"tags":["Grupos"],"summary":"Sai do grupo","description":"Faz o número conectado sair do grupo.","operationId":"postinstances_id_groups_jid_leave","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/groups/{jid}/settings":{"patch":{"tags":["Grupos"],"summary":"Restringe mensagens/edição e modo de entrada","description":"Restringe quem pode falar (announcement) ou quem pode editar as informações do grupo (locked).","operationId":"patchinstances_id_groups_jid_settings","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"setting":"announcement","memberAddMode":"admin_add","joinApprovalMode":"on"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/campaigns":{"post":{"tags":["Campanhas"],"summary":"Cria campanha e enfileira os envios","description":"Cria uma campanha e transforma cada destinatário em um job na fila da instância. Aceita agendamento e intervalo entre mensagens.","operationId":"postcampaigns","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"instanceId":"uuid","name":"Black Friday","numbers":["5511999999999"],"text":"Olá!","delayMessage":3,"scheduledAt":"2026-11-27T12:00:00.000Z"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"get":{"tags":["Campanhas"],"summary":"Lista campanhas com progresso","description":"Lista campanhas do workspace com progresso por status.","operationId":"getcampaigns","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/campaigns/{id}":{"get":{"tags":["Campanhas"],"summary":"Detalhe e estatísticas da campanha","description":"Retorna o detalhe da campanha, estatísticas e agendamento.","operationId":"getcampaigns_id","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Campanhas"],"summary":"Cancela os jobs pendentes da campanha","description":"Cancela os jobs ainda pendentes da campanha. Mensagens já enviadas não são desfeitas.","operationId":"deletecampaigns_id","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/campaigns/{id}/jobs":{"get":{"tags":["Campanhas"],"summary":"Jobs da campanha na fila","description":"Lista os jobs gerados por uma campanha.","operationId":"getcampaigns_id_jobs","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats":{"get":{"tags":["Conversas"],"summary":"Conversas recentes","description":"Lista as conversas recentes do histórico local com nome, última mensagem e horário.","operationId":"getinstances_id_chats","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/messages":{"get":{"tags":["Conversas"],"summary":"Mensagens de uma conversa","description":"Retorna as mensagens de uma conversa, ordenadas da mais antiga para a mais recente, com limite configurável.","operationId":"getinstances_id_chats_messages","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"jid=...&limit=200"}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/webhook-deliveries":{"get":{"tags":["Webhooks"],"summary":"Entregas da outbox","description":"Consulta a outbox de webhooks da instância e filtra por pendente, entregue ou falhou.","operationId":"getinstances_id_webhook_deliveries","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"status=pendente|entregue|falhou"}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/webhook-deliveries/retry":{"post":{"tags":["Webhooks"],"summary":"Reenfileira entregas falhas","description":"Recoloca entregas falhas ou pendentes na fila de envio. Sem ids, reenfileira todas as falhas.","operationId":"postinstances_id_webhook_deliveries_retry","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ids":[]}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/webhook-test":{"post":{"tags":["Webhooks"],"summary":"Dispara um evento de teste","description":"Dispara um evento de teste assinado para validar URL, HMAC e recebimento.","operationId":"postinstances_id_webhook_test","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/mcp":{"post":{"tags":["MCP"],"summary":"Servidor MCP Streamable HTTP","description":"Ponto único MCP Streamable HTTP. Recebe JSON-RPC (initialize, tools/list, tools/call) e expõe ferramentas de instâncias, mensagens, grupos e fila.","operationId":"postmcp","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/billing":{"get":{"tags":["Faturamento"],"summary":"Plano, limites e planos disponíveis","description":"Retorna plano, status da assinatura, limites, uso, planos disponíveis e se o Stripe está configurado.","operationId":"getbilling","security":[{"SessionCookie":[]}],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/billing/checkout":{"post":{"tags":["Faturamento"],"summary":"Cria Checkout Session","description":"Cria uma sessão de Stripe Checkout para assinar um plano. Bloqueia checkout duplicado quando já existe assinatura.","operationId":"postbilling_checkout","security":[{"SessionCookie":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"plan":"pro"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/billing/change-plan":{"post":{"tags":["Faturamento"],"summary":"Altera assinatura existente com proration","description":"Altera o plano de uma assinatura existente com proration, sem criar uma segunda assinatura.","operationId":"postbilling_change_plan","security":[{"SessionCookie":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"plan":"business"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/billing/portal":{"post":{"tags":["Faturamento"],"summary":"Abre o Billing Portal do Stripe","description":"Abre o Billing Portal do Stripe para atualizar cartão, faturas e cancelamento.","operationId":"postbilling_portal","security":[{"SessionCookie":[]}],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/billing/webhook":{"post":{"tags":["Faturamento"],"summary":"Webhook do Stripe (corpo cru)","description":"Recebe eventos do Stripe com validação de assinatura sobre o corpo cru e sincroniza o estado da assinatura.","operationId":"postbilling_webhook","security":[],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/settings":{"get":{"tags":["Configurações"],"summary":"Comportamento automático da instância","description":"Retorna os comportamentos automáticos da instância: auto-leitura, rejeição de chamadas e proteção de grupos de avisos.","operationId":"getinstances_id_settings","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"patch":{"tags":["Configurações"],"summary":"Atualiza auto-leitura, chamadas e proteção de grupos","description":"Atualiza auto-leitura de mensagens/status, rejeição automática de chamadas, mensagem de rejeição e announcement guard.","operationId":"patchinstances_id_settings","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"autoReadMessages":true,"autoReadStatus":true,"autoRejectCalls":true,"callRejectMessage":"Não posso atender agora.","announcementGuard":true}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/profile":{"get":{"tags":["Configurações"],"summary":"Perfil do número conectado","description":"Retorna nome, recado, foto e dados do dispositivo do número conectado.","operationId":"getinstances_id_profile","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"patch":{"tags":["Configurações"],"summary":"Atualiza nome e recado do perfil","description":"Atualiza o nome e o recado do perfil do WhatsApp.","operationId":"patchinstances_id_profile","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"Atendimento","status":"Seg a sex, 9h às 18h"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/profile/picture":{"put":{"tags":["Configurações"],"summary":"Atualiza a foto do perfil","description":"Troca a foto do perfil a partir de URL HTTPS ou base64.","operationId":"putinstances_id_profile_picture","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"url":"https://.../avatar.jpg"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Configurações"],"summary":"Remove a foto do perfil","description":"Remove a foto do perfil do número conectado.","operationId":"deleteinstances_id_profile_picture","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/device":{"get":{"tags":["Configurações"],"summary":"Dados do dispositivo conectado","description":"Retorna JID, telefone, nome e plataforma do dispositivo conectado.","operationId":"getinstances_id_device","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/restart":{"post":{"tags":["Configurações"],"summary":"Reinicia o socket da instância","description":"Fecha e reabre o socket da instância sem apagar a sessão.","operationId":"postinstances_id_restart","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/qr/bytes":{"get":{"tags":["Configurações"],"summary":"QR code em PNG (bytes)","description":"Baixa o QR code atual como imagem PNG binária.","operationId":"getinstances_id_qr_bytes","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/qr/image":{"get":{"tags":["Configurações"],"summary":"QR code como data URL","description":"Retorna o QR code como data URL para renderização no frontend.","operationId":"getinstances_id_qr_image","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/extension-token":{"post":{"tags":["Configurações"],"summary":"Token efêmero de conexão/embed","description":"Gera um token efêmero de 10 minutos para abrir a página/iframe de conexão.","operationId":"postinstances_id_extension_token","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/privacy":{"get":{"tags":["Privacidade"],"summary":"Configurações de privacidade atuais","description":"Consulta as configurações de privacidade atuais do número.","operationId":"getinstances_id_privacy","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"patch":{"tags":["Privacidade"],"summary":"Atualiza privacidade do número","description":"Altera último acesso, foto, recado, online, confirmações, grupos, chamadas, mensagens e desaparecimento.","operationId":"patchinstances_id_privacy","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"lastSeen":"contacts","profilePhoto":"contacts","readReceipts":"all","groupsAdd":"contacts","calls":"known"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/privacy/blocklist":{"get":{"tags":["Privacidade"],"summary":"Lista contatos bloqueados","description":"Lista os JIDs bloqueados pelo número conectado.","operationId":"getinstances_id_privacy_blocklist","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/privacy/disallowed-contacts":{"get":{"tags":["Privacidade"],"summary":"Contatos não permitidos (não suportado)","description":"Contatos não permitidos (não suportado).","operationId":"getinstances_id_privacy_disallowed_contacts","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/contacts":{"get":{"tags":["Contatos"],"summary":"Lista contatos conhecidos localmente","description":"Lista contatos conhecidos localmente, com busca por nome, telefone ou JID.","operationId":"getinstances_id_contacts","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"q=&limit=200"}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["Contatos"],"summary":"Adiciona ou edita contato","description":"Adiciona ou edita um contato na agenda do WhatsApp.","operationId":"postinstances_id_contacts","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"phone":"5511999999999","name":"Maria Silva","saveOnPrimaryAddressbook":true}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/contacts/blocked":{"get":{"tags":["Contatos"],"summary":"Lista contatos bloqueados","description":"Lista os contatos bloqueados.","operationId":"getinstances_id_contacts_blocked","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/contacts/check":{"post":{"tags":["Contatos"],"summary":"Verifica números em lote","description":"Verifica em lote quais números possuem WhatsApp.","operationId":"postinstances_id_contacts_check","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"numbers":["5511999999999"]}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/contacts/{jid}":{"get":{"tags":["Contatos"],"summary":"Metadados de um contato","description":"Retorna existência, nome local, foto e contagem de mensagens de um contato.","operationId":"getinstances_id_contacts_jid","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Contatos"],"summary":"Remove contato da agenda","description":"Remove o contato da agenda do WhatsApp.","operationId":"deleteinstances_id_contacts_jid","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/contacts/{jid}/picture":{"get":{"tags":["Contatos"],"summary":"Foto do contato","description":"Retorna a URL da foto do contato.","operationId":"getinstances_id_contacts_jid_picture","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/contacts/{jid}/status":{"get":{"tags":["Contatos"],"summary":"Recado/status do contato","description":"Consulta o recado/status do contato.","operationId":"getinstances_id_contacts_jid_status","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/contacts/{jid}/business":{"get":{"tags":["Contatos"],"summary":"Perfil business do contato","description":"Retorna o perfil business do contato, quando existir.","operationId":"getinstances_id_contacts_jid_business","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/contacts/{jid}/block":{"post":{"tags":["Contatos"],"summary":"Bloqueia contato","description":"Bloqueia o contato.","operationId":"postinstances_id_contacts_jid_block","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Contatos"],"summary":"Desbloqueia contato","description":"Desbloqueia o contato.","operationId":"deleteinstances_id_contacts_jid_block","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/contacts/{jid}/report":{"post":{"tags":["Contatos"],"summary":"Denuncia contato (não suportado)","description":"Denuncia contato (não suportado).","operationId":"postinstances_id_contacts_jid_report","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/contacts/{jid}/labels":{"get":{"tags":["Contatos"],"summary":"Etiquetas do contato (não suportado)","description":"Etiquetas do contato (não suportado).","operationId":"getinstances_id_contacts_jid_labels","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/{jid}":{"get":{"tags":["Conversas"],"summary":"Detalhe do chat","description":"Retorna resumo, foto, mensagens recentes e metadados do grupo quando aplicável.","operationId":"getinstances_id_chats_jid","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"patch":{"tags":["Conversas"],"summary":"Arquiva, fixa, muta, lê ou expira o chat","description":"Combina arquivamento, fixação, mudo, leitura e expiração em uma chamada.","operationId":"patchinstances_id_chats_jid","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"archive":true,"pin":false,"muteSeconds":3600,"read":true,"expirationSeconds":86400}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Conversas"],"summary":"Deleta o chat","description":"Deleta o chat para o número conectado.","operationId":"deleteinstances_id_chats_jid","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/{jid}/messages":{"get":{"tags":["Conversas"],"summary":"Mensagens do chat","description":"Lista as mensagens locais do chat com limite configurável.","operationId":"getinstances_id_chats_jid_messages","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}},{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"limit=200"}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/{jid}/picture":{"get":{"tags":["Conversas"],"summary":"Foto do chat/contato","description":"Retorna a foto do contato ou grupo.","operationId":"getinstances_id_chats_jid_picture","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/{jid}/presence":{"post":{"tags":["Conversas"],"summary":"Atualiza presença no chat","description":"Atualiza presença (digitando, pausado, disponível) no chat.","operationId":"postinstances_id_chats_jid_presence","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"state":"composing"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/{jid}/archive":{"post":{"tags":["Conversas"],"summary":"Arquiva/desarquiva chat","description":"Arquiva ou desarquiva o chat.","operationId":"postinstances_id_chats_jid_archive","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"archive":true}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/{jid}/pin":{"post":{"tags":["Conversas"],"summary":"Fixa/desafixa chat","description":"Fixa ou desafixa o chat.","operationId":"postinstances_id_chats_jid_pin","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"pin":true}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/{jid}/mute":{"post":{"tags":["Conversas"],"summary":"Muta/desmuta chat","description":"Muta ou desmuta o chat por duração em segundos.","operationId":"postinstances_id_chats_jid_mute","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"seconds":3600}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/{jid}/read":{"post":{"tags":["Conversas"],"summary":"Marca chat como lido/não lido","description":"Marca o chat como lido ou não lido.","operationId":"postinstances_id_chats_jid_read","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"read":true}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/{jid}/clear":{"post":{"tags":["Conversas"],"summary":"Limpa mensagens do chat","description":"Limpa as mensagens do chat no WhatsApp e no histórico local.","operationId":"postinstances_id_chats_jid_clear","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/{jid}/expiration":{"post":{"tags":["Conversas"],"summary":"Define mensagens temporárias","description":"Define mensagens temporárias para o chat.","operationId":"postinstances_id_chats_jid_expiration","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"seconds":86400}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/{jid}/labels":{"get":{"tags":["Conversas"],"summary":"Etiquetas vinculadas ao chat","description":"Lista as etiquetas vinculadas ao chat no Vértice.","operationId":"getinstances_id_chats_jid_labels","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["Conversas"],"summary":"Vincula etiqueta ao chat","description":"Vincula uma etiqueta ao chat e ao app state do WhatsApp.","operationId":"postinstances_id_chats_jid_labels","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"labelId":"uuid"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/{jid}/labels/{labelId}":{"delete":{"tags":["Conversas"],"summary":"Remove etiqueta do chat","description":"Remove a etiqueta do chat.","operationId":"deleteinstances_id_chats_jid_labels_labelId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}},{"name":"labelId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/chats/{jid}/note":{"get":{"tags":["Conversas"],"summary":"Nota interna do chat","description":"Retorna a nota interna do chat.","operationId":"getinstances_id_chats_jid_note","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"put":{"tags":["Conversas"],"summary":"Salva nota interna do chat","description":"Salva uma nota interna do chat no Postgres do Vértice.","operationId":"putinstances_id_chats_jid_note","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"note":"Cliente VIP"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/calls":{"get":{"tags":["Ligações"],"summary":"Histórico recente de chamadas","description":"Lista as chamadas recentes observadas pelo socket.","operationId":"getinstances_id_calls","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"limit=50"}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["Ligações"],"summary":"Iniciar chamada (não suportado)","description":"Tentativa de originar chamada; não suportado pelo Baileys.","operationId":"postinstances_id_calls","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/calls/reject":{"post":{"tags":["Ligações"],"summary":"Rejeita uma chamada recebida","description":"Rejeita uma chamada recebida pelo ID e JID do autor.","operationId":"postinstances_id_calls_reject","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"callId":"ABC","from":"5511999999999@s.whatsapp.net"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/calls/link":{"post":{"tags":["Ligações"],"summary":"Gera link de chamada","description":"Gera um link de chamada de áudio ou vídeo.","operationId":"postinstances_id_calls_link","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"type":"audio"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/calls/token":{"post":{"tags":["Ligações"],"summary":"Token da SDK de chamadas (não suportado)","description":"Token da SDK de chamadas (não suportado).","operationId":"postinstances_id_calls_token","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/calls/sip-token":{"post":{"tags":["Ligações"],"summary":"Credenciais SIP (não suportado)","description":"Credenciais SIP (não suportado).","operationId":"postinstances_id_calls_sip_token","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/calls/sip-info":{"get":{"tags":["Ligações"],"summary":"Informações SIP (não suportado)","description":"Informações SIP (não suportado).","operationId":"getinstances_id_calls_sip_info","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/communities":{"get":{"tags":["Comunidades"],"summary":"Lista comunidades","description":"Lista as comunidades das quais o número participa.","operationId":"getinstances_id_communities","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["Comunidades"],"summary":"Cria comunidade","description":"Cria uma comunidade com nome e descrição.","operationId":"postinstances_id_communities","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"subject":"Comunidade","description":"Descrição"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/communities/invite/{code}":{"get":{"tags":["Comunidades"],"summary":"Metadados de convite de comunidade","description":"Metadados de convite de comunidade.","operationId":"getinstances_id_communities_invite_code","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/communities/join":{"post":{"tags":["Comunidades"],"summary":"Entra em comunidade por convite","description":"Entra em comunidade por convite.","operationId":"postinstances_id_communities_join","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"code":"ABC123"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/communities/{jid}":{"get":{"tags":["Comunidades"],"summary":"Metadados da comunidade","description":"Retorna metadados e participantes da comunidade.","operationId":"getinstances_id_communities_jid","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"patch":{"tags":["Comunidades"],"summary":"Atualiza nome/descrição","description":"Atualiza nome/descrição.","operationId":"patchinstances_id_communities_jid","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"subject":"Novo nome","description":"Nova descrição"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Comunidades"],"summary":"Sai da comunidade","description":"Sai da comunidade.","operationId":"deleteinstances_id_communities_jid","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/communities/{jid}/leave":{"post":{"tags":["Comunidades"],"summary":"Sai da comunidade","description":"Sai da comunidade.","operationId":"postinstances_id_communities_jid_leave","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/communities/{jid}/groups":{"get":{"tags":["Comunidades"],"summary":"Lista grupos vinculados","description":"Lista os grupos vinculados à comunidade.","operationId":"getinstances_id_communities_jid_groups","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["Comunidades"],"summary":"Cria/vincula grupo à comunidade","description":"Cria um grupo vinculado ou vincula grupos existentes.","operationId":"postinstances_id_communities_jid_groups","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"groups":["1203630...@g.us"]}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Comunidades"],"summary":"Desvincula grupos","description":"Desvincula grupos da comunidade.","operationId":"deleteinstances_id_communities_jid_groups","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"groups":["1203630...@g.us"]}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/communities/{jid}/invite":{"get":{"tags":["Comunidades"],"summary":"Link de convite da comunidade","description":"Retorna o link de convite da comunidade.","operationId":"getinstances_id_communities_jid_invite","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/communities/{jid}/invite/revoke":{"post":{"tags":["Comunidades"],"summary":"Revoga link de convite","description":"Revoga e gera um novo link de convite.","operationId":"postinstances_id_communities_jid_invite_revoke","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/communities/{jid}/requests":{"get":{"tags":["Comunidades"],"summary":"Solicitações de entrada","description":"Lista solicitações de entrada na comunidade.","operationId":"getinstances_id_communities_jid_requests","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/communities/{jid}/participants":{"post":{"tags":["Comunidades"],"summary":"Gerencia participantes","description":"Adiciona, remove, promove, rebaixa, aprova ou rejeita participantes.","operationId":"postinstances_id_communities_jid_participants","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"participants":["5511999999999"],"action":"add"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/communities/{jid}/settings":{"patch":{"tags":["Comunidades"],"summary":"Configurações da comunidade","description":"Altera restrições, modo de adição e aprovação de entrada.","operationId":"patchinstances_id_communities_jid_settings","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"setting":"announcement"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/newsletters":{"get":{"tags":["Canais"],"summary":"Listar canais (não suportado)","description":"Listagem de todos os canais não é exposta pelo protocolo.","operationId":"getinstances_id_newsletters","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["Canais"],"summary":"Cria canal","description":"Cria um canal (newsletter).","operationId":"postinstances_id_newsletters","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"Canal","description":"Descrição"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/newsletters/search":{"get":{"tags":["Canais"],"summary":"Buscar canais (não suportado)","description":"Buscar canais (não suportado).","operationId":"getinstances_id_newsletters_search","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/newsletters/invite/{code}":{"get":{"tags":["Canais"],"summary":"Metadados de canal por convite","description":"Metadados de canal por convite.","operationId":"getinstances_id_newsletters_invite_code","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"code","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/newsletters/{jid}":{"get":{"tags":["Canais"],"summary":"Metadados do canal","description":"Retorna metadados do canal por JID.","operationId":"getinstances_id_newsletters_jid","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"patch":{"tags":["Canais"],"summary":"Atualiza nome/descrição do canal","description":"Atualiza nome e descrição do canal.","operationId":"patchinstances_id_newsletters_jid","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"Novo nome"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Canais"],"summary":"Deleta canal","description":"Deleta o canal.","operationId":"deleteinstances_id_newsletters_jid","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/newsletters/{jid}/picture":{"put":{"tags":["Canais"],"summary":"Atualiza foto do canal","description":"Atualiza a foto do canal.","operationId":"putinstances_id_newsletters_jid_picture","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"url":"https://.../canal.jpg"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Canais"],"summary":"Remove foto do canal","description":"Remove foto do canal.","operationId":"deleteinstances_id_newsletters_jid_picture","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/newsletters/{jid}/follow":{"post":{"tags":["Canais"],"summary":"Segue canal","description":"Segue o canal.","operationId":"postinstances_id_newsletters_jid_follow","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/newsletters/{jid}/unfollow":{"post":{"tags":["Canais"],"summary":"Deixa de seguir canal","description":"Deixa de seguir o canal.","operationId":"postinstances_id_newsletters_jid_unfollow","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/newsletters/{jid}/mute":{"post":{"tags":["Canais"],"summary":"Muta canal","description":"Muta notificações do canal.","operationId":"postinstances_id_newsletters_jid_mute","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/newsletters/{jid}/unmute":{"post":{"tags":["Canais"],"summary":"Desmuta canal","description":"Desmuta canal.","operationId":"postinstances_id_newsletters_jid_unmute","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/newsletters/{jid}/subscribers":{"get":{"tags":["Canais"],"summary":"Contagem de seguidores/admins","description":"Retorna contagem de seguidores e administradores.","operationId":"getinstances_id_newsletters_jid_subscribers","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/newsletters/{jid}/messages":{"get":{"tags":["Canais"],"summary":"Mensagens do canal","description":"Lista mensagens recentes do canal.","operationId":"getinstances_id_newsletters_jid_messages","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}},{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"count=50&since=0&after=0"}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/newsletters/{jid}/react":{"post":{"tags":["Canais"],"summary":"Reage a mensagem do canal","description":"Reage a uma mensagem do canal.","operationId":"postinstances_id_newsletters_jid_react","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"serverId":"...","reaction":"👍"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/newsletters/{jid}/transfer":{"post":{"tags":["Canais"],"summary":"Transfere propriedade do canal","description":"Transfere a propriedade do canal.","operationId":"postinstances_id_newsletters_jid_transfer","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"newOwnerJid":"5511999999999"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/newsletters/{jid}/admins/{userJid}/demote":{"post":{"tags":["Canais"],"summary":"Remove admin do canal","description":"Remove admin do canal.","operationId":"postinstances_id_newsletters_jid_admins_userJid_demote","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}},{"name":"userJid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/business/profile":{"get":{"tags":["WhatsApp Business"],"summary":"Perfil business","description":"Retorna o perfil comercial do número conectado.","operationId":"getinstances_id_business_profile","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"patch":{"tags":["WhatsApp Business"],"summary":"Atualiza perfil business","description":"Atualiza descrição, e-mail, sites, endereço e horário comercial.","operationId":"patchinstances_id_business_profile","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"description":"Empresa","email":"contato@empresa.com","websites":["https://empresa.com"]}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/business/cover-photo":{"put":{"tags":["WhatsApp Business"],"summary":"Atualiza foto de capa business","description":"Atualiza foto de capa business.","operationId":"putinstances_id_business_cover_photo","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"url":"https://.../capa.jpg"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/business/cover-photo/{photoId}":{"delete":{"tags":["WhatsApp Business"],"summary":"Remove foto de capa business","description":"Remove foto de capa business.","operationId":"deleteinstances_id_business_cover_photo_photoId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"photoId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/business/catalog":{"get":{"tags":["WhatsApp Business"],"summary":"Catálogo de produtos","description":"Lista produtos do catálogo do WhatsApp Business.","operationId":"getinstances_id_business_catalog","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"limit=50&cursor="}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/business/catalog/{jid}":{"get":{"tags":["WhatsApp Business"],"summary":"Catálogo de outro número","description":"Catálogo de outro número.","operationId":"getinstances_id_business_catalog_jid","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"jid","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/business/products":{"get":{"tags":["WhatsApp Business"],"summary":"Lista produtos","description":"Lista produtos.","operationId":"getinstances_id_business_products","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["WhatsApp Business"],"summary":"Cria produto","description":"Cria um produto com imagens, preço, moeda e descrição.","operationId":"postinstances_id_business_products","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"Produto","description":"Descrição","price":99.9,"currency":"BRL","images":["https://.../produto.jpg"]}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/business/products/{productId}":{"get":{"tags":["WhatsApp Business"],"summary":"Detalhe do produto","description":"Retorna um produto específico do catálogo.","operationId":"getinstances_id_business_products_productId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"patch":{"tags":["WhatsApp Business"],"summary":"Atualiza produto","description":"Atualiza os dados de um produto.","operationId":"patchinstances_id_business_products_productId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"price":109.9}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["WhatsApp Business"],"summary":"Deleta produto","description":"Remove um produto do catálogo.","operationId":"deleteinstances_id_business_products_productId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"productId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/business/collections":{"get":{"tags":["WhatsApp Business"],"summary":"Lista coleções","description":"Lista as coleções do catálogo.","operationId":"getinstances_id_business_collections","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["WhatsApp Business"],"summary":"Cria coleção (não suportado)","description":"Cria coleção (não suportado).","operationId":"postinstances_id_business_collections","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/business/collections/{collectionId}":{"patch":{"tags":["WhatsApp Business"],"summary":"Edita coleção (não suportado)","description":"Edita coleção (não suportado).","operationId":"patchinstances_id_business_collections_collectionId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"collectionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["WhatsApp Business"],"summary":"Deleta coleção (não suportado)","description":"Deleta coleção (não suportado).","operationId":"deleteinstances_id_business_collections_collectionId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"collectionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/business/labels":{"get":{"tags":["WhatsApp Business"],"summary":"Lista etiquetas","description":"Lista as etiquetas business persistidas no Vértice.","operationId":"getinstances_id_business_labels","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["WhatsApp Business"],"summary":"Cria etiqueta","description":"Cria uma etiqueta e a replica no app state do WhatsApp.","operationId":"postinstances_id_business_labels","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"VIP","color":3}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/business/labels/{labelId}":{"patch":{"tags":["WhatsApp Business"],"summary":"Edita etiqueta","description":"Edita nome/cor da etiqueta.","operationId":"patchinstances_id_business_labels_labelId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"labelId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"VIP Plus"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["WhatsApp Business"],"summary":"Deleta etiqueta","description":"Remove a etiqueta e suas associações.","operationId":"deleteinstances_id_business_labels_labelId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"labelId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/business/quick-replies":{"get":{"tags":["WhatsApp Business"],"summary":"Respostas rápidas (não suportado)","description":"Respostas rápidas (não suportado).","operationId":"getinstances_id_business_quick_replies","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["WhatsApp Business"],"summary":"Cria/edita resposta rápida","description":"Cria/edita resposta rápida.","operationId":"postinstances_id_business_quick_replies","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"shortcut":"/pix","message":"Chave PIX: ..."}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/business/quick-replies/{shortcut}":{"delete":{"tags":["WhatsApp Business"],"summary":"Remove resposta rápida","description":"Remove resposta rápida.","operationId":"deleteinstances_id_business_quick_replies_shortcut","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"shortcut","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/business/orders/{orderId}":{"get":{"tags":["WhatsApp Business"],"summary":"Detalhe de pedido","description":"Retorna os detalhes de um pedido a partir de orderId e token.","operationId":"getinstances_id_business_orders_orderId","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"orderId","in":"path","required":true,"schema":{"type":"string"}},{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"token=..."}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/status":{"get":{"tags":["Status"],"summary":"Listar status (não suportado)","description":"Listagem de status de contatos não é exposta pelo protocolo.","operationId":"getinstances_id_status","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/status/text":{"post":{"tags":["Status"],"summary":"Publica status de texto","description":"Publica um status de texto para os contatos informados ou para os contatos locais.","operationId":"postinstances_id_status_text","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"text":"Novo status","backgroundColor":"#111111"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/status/image":{"post":{"tags":["Status"],"summary":"Publica status de imagem","description":"Publica um status de imagem com legenda opcional.","operationId":"postinstances_id_status_image","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"url":"https://.../status.jpg","caption":"Legenda"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/status/video":{"post":{"tags":["Status"],"summary":"Publica status de vídeo","description":"Publica um status de vídeo.","operationId":"postinstances_id_status_video","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"url":"https://.../status.mp4"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/status/reply":{"post":{"tags":["Status"],"summary":"Responde a um status com texto","description":"Responde a um status recente usando a mensagem em cache.","operationId":"postinstances_id_status_reply","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"jid":"5511999999999","messageId":"ABC","text":"Legal!"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/status/reply/gif":{"post":{"tags":["Status"],"summary":"Responde a um status com GIF","description":"Responde a um status com GIF.","operationId":"postinstances_id_status_reply_gif","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"jid":"5511999999999","messageId":"ABC","url":"https://.../gif.mp4"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/status/reply/sticker":{"post":{"tags":["Status"],"summary":"Responde a um status com figurinha","description":"Responde a um status com figurinha.","operationId":"postinstances_id_status_reply_sticker","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"jid":"5511999999999","messageId":"ABC","url":"https://.../sticker.webp"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/gif":{"post":{"tags":["Mensagens"],"summary":"Envia GIF","description":"Envia um GIF (vídeo com reprodução automática).","operationId":"postinstances_id_messages_gif","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"to":"5511999999999","url":"https://.../anim.gif"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/ptv":{"post":{"tags":["Mensagens"],"summary":"Envia vídeo circular (PTV)","description":"Envia um vídeo circular (PTV).","operationId":"postinstances_id_messages_ptv","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"to":"5511999999999","url":"https://.../video.mp4"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/link":{"post":{"tags":["Mensagens"],"summary":"Envia link com preview","description":"Envia um texto com URL para gerar preview de link.","operationId":"postinstances_id_messages_link","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"to":"5511999999999","url":"https://exemplo.com","text":"Confira"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/contacts":{"post":{"tags":["Mensagens"],"summary":"Envia múltiplos contatos","description":"Envia múltiplos contatos em vCard.","operationId":"postinstances_id_messages_contacts","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"to":"5511999999999","contacts":[{"name":"Maria","phone":"5511888888888"}]}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/product":{"post":{"tags":["Mensagens"],"summary":"Envia produto do catálogo","description":"Envia um produto do catálogo em uma mensagem.","operationId":"postinstances_id_messages_product","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"to":"5511999999999","productId":"123","body":"Confira"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/event":{"post":{"tags":["Mensagens"],"summary":"Envia evento","description":"Envia um evento de calendário em um chat ou grupo.","operationId":"postinstances_id_messages_event","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"to":"1203630...@g.us","name":"Reunião","startDate":"2026-11-01T15:00:00.000Z"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/pin":{"post":{"tags":["Mensagens"],"summary":"Fixa/desafixa mensagem","description":"Fixa ou desafixa uma mensagem no chat.","operationId":"postinstances_id_messages_pin","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"to":"5511999999999","messageId":"ABC","type":"pin","time":604800}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/buttons":{"post":{"tags":["Mensagens"],"summary":"Botões de ação (não suportado)","description":"Botões interativos não são expostos pelo Baileys.","operationId":"postinstances_id_messages_buttons","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/buttons/list":{"post":{"tags":["Mensagens"],"summary":"Lista de botões (não suportado)","description":"Lista de botões (não suportado).","operationId":"postinstances_id_messages_buttons_list","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/options-list":{"post":{"tags":["Mensagens"],"summary":"Lista de opções (não suportado)","description":"Lista de opções (não suportado).","operationId":"postinstances_id_messages_options_list","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/carousel":{"post":{"tags":["Mensagens"],"summary":"Carrossel (não suportado)","description":"Carrossel interativo não é exposto pelo Baileys.","operationId":"postinstances_id_messages_carousel","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/order":{"post":{"tags":["Mensagens"],"summary":"Pedido (não suportado)","description":"Pedidos do catálogo não são expostos pelo Baileys.","operationId":"postinstances_id_messages_order","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/messages/poll-vote":{"post":{"tags":["Mensagens"],"summary":"Voto em enquete (não suportado)","description":"Voto em enquete (não suportado).","operationId":"postinstances_id_messages_poll_vote","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"202":{"description":"Mensagem enfileirada","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"zaapId":{"type":"string"},"status":{"type":"string","const":"queued"}}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/partner/instances":{"get":{"tags":["Parceiros"],"summary":"Lista instâncias de parceiro","description":"Lista instâncias de parceiro.","operationId":"getpartner_instances","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"tenantId="}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["Parceiros"],"summary":"Cria instância para um workspace","description":"Cria instância para um workspace.","operationId":"postpartner_instances","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"tenantId":"uuid","name":"Cliente","webhookUrl":"https://.../hooks"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/partner/instances/{id}":{"delete":{"tags":["Parceiros"],"summary":"Remove instância de parceiro","description":"Remove instância de parceiro.","operationId":"deletepartner_instances_id","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/partner/instances/{id}/extension-token":{"post":{"tags":["Parceiros"],"summary":"Token de conexão/embed do parceiro","description":"Token de conexão/embed do parceiro.","operationId":"postpartner_instances_id_extension_token","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/partner/instances/{id}/sign":{"post":{"tags":["Parceiros"],"summary":"Assinatura de parceiro (via Stripe/admin)","description":"Assinatura de parceiro (via Stripe/admin).","operationId":"postpartner_instances_id_sign","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/partner/instances/{id}/unsubscribe":{"post":{"tags":["Parceiros"],"summary":"Cancelamento de parceiro (via Stripe/admin)","description":"Cancelamento de parceiro (via Stripe/admin).","operationId":"postpartner_instances_id_unsubscribe","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/integrators/find-my-pack":{"get":{"tags":["Parceiros"],"summary":"Integração Find My Pack (não configurada)","description":"Integração Find My Pack (não configurada).","operationId":"getintegrators_find_my_pack","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/mobile/registration-available":{"post":{"tags":["Mobile"],"summary":"Registro mobile (não suportado)","description":"Registro mobile não é exposto pelo protocolo WhatsApp Web.","operationId":"postinstances_id_mobile_registration_available","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/mobile/request-code":{"post":{"tags":["Mobile"],"summary":"Código de registro mobile (não suportado)","description":"Código de registro mobile (não suportado).","operationId":"postinstances_id_mobile_request_code","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/mobile/captcha-confirm":{"post":{"tags":["Mobile"],"summary":"Captcha mobile (não suportado)","description":"Captcha mobile (não suportado).","operationId":"postinstances_id_mobile_captcha_confirm","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/mobile/device-transfer-confirmed":{"post":{"tags":["Mobile"],"summary":"Transferência mobile (não suportado)","description":"Transferência mobile (não suportado).","operationId":"postinstances_id_mobile_device_transfer_confirmed","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/mobile/request-unbanning":{"post":{"tags":["Mobile"],"summary":"Desbanimento mobile (não suportado)","description":"Desbanimento mobile (não suportado).","operationId":"postinstances_id_mobile_request_unbanning","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/mobile/get-account-email":{"get":{"tags":["Mobile"],"summary":"E-mail da conta mobile (não suportado)","description":"E-mail da conta mobile (não suportado).","operationId":"getinstances_id_mobile_get_account_email","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/mobile/set-account-email":{"post":{"tags":["Mobile"],"summary":"Cadastrar e-mail mobile (não suportado)","description":"Cadastrar e-mail mobile (não suportado).","operationId":"postinstances_id_mobile_set_account_email","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/mobile/verify-account-email":{"post":{"tags":["Mobile"],"summary":"Verificar e-mail mobile (não suportado)","description":"Verificar e-mail mobile (não suportado).","operationId":"postinstances_id_mobile_verify_account_email","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/mobile/set-security-code":{"post":{"tags":["Mobile"],"summary":"Cadastrar PIN mobile (não suportado)","description":"Cadastrar PIN mobile (não suportado).","operationId":"postinstances_id_mobile_set_security_code","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/mobile/remove-security-code":{"delete":{"tags":["Mobile"],"summary":"Remover PIN mobile (não suportado)","description":"Remover PIN mobile (não suportado).","operationId":"deleteinstances_id_mobile_remove_security_code","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/meta-ai":{"post":{"tags":["Mobile"],"summary":"Conversar com Meta AI (não suportado)","description":"Conversar com Meta AI (não suportado).","operationId":"postinstances_id_meta_ai","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/broadcast-lists":{"post":{"tags":["Mobile"],"summary":"Listas de transmissão nativas (não suportado)","description":"Listas de transmissão nativas não são expostas pelo protocolo.","operationId":"postinstances_id_broadcast_lists","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/token/{token}/send-text":{"post":{"tags":["Compatibilidade"],"summary":"Alias Z-API para envio de texto","description":"Alias Z-API para enviar texto. Autentica pelo token da URL (API key) e aceita Client-Token opcional.","operationId":"postinstances_id_token_token_send_text","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"phone":"5511999999999","message":"Olá!"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/token/{token}/send-image":{"post":{"tags":["Compatibilidade"],"summary":"Alias Z-API para envio de imagem","description":"Alias Z-API para enviar imagem por URL ou base64.","operationId":"postinstances_id_token_token_send_image","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"phone":"5511999999999","image":"https://.../foto.jpg","caption":"Legenda"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/token/{token}/send-reaction":{"post":{"tags":["Compatibilidade"],"summary":"Alias Z-API para reação","description":"Alias Z-API para reagir a uma mensagem.","operationId":"postinstances_id_token_token_send_reaction","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"phone":"5511999999999","messageId":"ABC","reaction":"👍"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/instances/{id}/token/{token}/get-chats":{"get":{"tags":["Compatibilidade"],"summary":"Alias Z-API para conversas","description":"Alias Z-API para listar conversas da instância.","operationId":"getinstances_id_token_token_get_chats","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]},{"SessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/admin/overview":{"get":{"tags":["Admin"],"summary":"Visão agregada da plataforma","description":"Visão da plataforma com workspaces, usuários, instâncias, MRR e distribuição por plano e status.","operationId":"getadmin_overview","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/admin/tenants":{"get":{"tags":["Admin"],"summary":"Lista workspaces com uso","description":"Lista workspaces com uso de membros e instâncias. Aceita busca por nome ou slug.","operationId":"getadmin_tenants","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/admin/tenants/{id}":{"patch":{"tags":["Admin"],"summary":"Plano, status, limites e suspensão","description":"Ajusta plano, status, limites, suspensão e dias de teste de um workspace.","operationId":"patchadmin_tenants_id","security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"plan":"business","status":"active"}}}}},"responses":{"200":{"description":"Sucesso","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}