Esta documentação técnica explica como o Conexa realiza o envio de requisições de eventos (Webhooks) para o seu sistema, detalhando os campos, tipos e formatos transmitidos. Se você deseja uma introdução sobre Webhooks, confira este artigo.
\nApós a ocorrência de um evento no Conexa, a notificação (requisição) é enviada de forma assíncrona em até 5 minutos, com no máximo 3 tentativas e um tempo limite de 15 segundos para cada requisição.
\nCaso um Webhook (Conexão) apresente 5 falhas consecutivas, ele será automaticamente bloqueado.
\nQuando houver Webhooks bloqueados, um aviso será exibido na página inicial do sistema Conexa. Ao clicar nesse aviso, você poderá visualizar os Webhooks bloqueados e terá a opção de desbloqueá-los.
\nPara acessar a documentação dos endpoints na API, clique aqui.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"25182821","collectionId":"1a5ac36c-239b-4a3a-aba3-e4ee0fdb7c7f","publishedId":"2sBXwsKVK6","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-06-10T15:43:34.000Z"},"item":[{"name":"Cobrança","item":[{"name":"Geração de Cobrança","id":"c5a38c1f-6b77-4b3b-a04a-a1cc0c8e7b73","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"chargeId\": 1,\n \"receivingMethod\": 1,\n \"type\": \"contractual\",\n \"status\": \"unpaid\",\n \"amount\": 1337,\n \"currentAmount\": 1337,\n \"rawAmount\": 1337,\n \"hasISSRetention\": false,\n \"ISSAmount\": 0,\n \"discountAmount\": 0,\n \"installmentNumber\": 1,\n \"totalInstallmentsAmount\": 1,\n \"dueDate\": \"2026-05-04\",\n \"competenceDate\": \"2026-05-04\",\n \"notes\": \"Reserva\",\n \"taxInvoiceNumber\": null,\n \"createdAt\": \"2026-05-04T16:39:58-03:00\",\n \"receiptCode\": null,\n \"billetDigitableLine\": null,\n \"chargeUrl\": \"https://Ao gerar uma cobrança (avulsa ou contratual), o evento será disparado (com o status \"Pendente\") em dois momentos distintos:
\nCaso o meio de faturamento seja \"Outros\", será disparado após o faturamento
\nCaso o meio de faturamento seja boleto, será disparado após a geração do boleto (via API ou arquivo de remessa)
\nO evento será disparado quando uma cobrança for quitada de forma automática (boleto, API, Cielo, Pix e etc) ou via quitação por arquivo de retorno. A quitação manual da cobrança (ação do usuário através do Conexa) não irá disparar o evento.
\nDispara eventos quando a data atual atingir X dias de diferença em relação ao vencimento de uma cobrança. Por exemplo, enviar um evento quando atingir 5 dias de atraso.
\nPara tal, ao criar uma Conexão deste evento, o usuário deve selecionar uma \"Regra de Aviso\" para vincular à Conexão.
\nOs avisos de cobrança podem ser qualquer regra pré-cadastrada em Configurações -> E-mails automáticos de cobrança. É ela quem determina com quantos dias de atraso aquele evento deve ser disparado, etc.
\nDispara eventos em qualquer ocasião que mude o status de uma cobrança, exceto a quitação (pois já existe um evento específico para isso).
\nOu seja, dispara um evento ao editar o status da cobrança, ao negociá-la, cancelá-la, ou excluí-la.
\nEvento disparado ao confirmar o recebimento de uma despesa fixa.
\nEvento disparado ao cadastrar um novo cliente. É disparado também nos cadastros realizados pelo cadastro público e através da contratação online de planos.
\nEvento disparado quando um cliente for bloqueado.
\nEvento disparado ao atualizar os dados de um cliente.
\nEvento disparado quando um cliente for excluído.
\nEvento disparado quando um cliente for desbloqueado.
\nEvento disparado sempre que uma reserva avulsa for criada.
\nEvento disparado sempre que uma reserva avulsa for editada.
\nEvento disparado quando uma reserva é cancelada
\nEvento disparado sempre que uma pessoa é cadastrada.
\nEvento disparado sempre que uma pessoa é editada.
\nEvento disparado sempre que uma pessoa é excluída.
\nEvento disparado sempre que uma pessoa é desativada.
\nEvento disparado sempre que uma pessoa é reativada.
\nEvento disparado sempre que uma reserva recorrente é criada.
\nO evento só será disparado para a reserva recorrente e não para as reservas criadas a partir de uma reserva recorrente.
\nEvento disparado sempre que um atendimento (para um cliente não bloqueado) é cadastrado.
\nEvento disparado sempre que um atendimento para um cliente bloqueado é cadastrado.
\nEvento disparado sempre que um atendimento é excluído.
\nEvento disparado sempre que uma correspondência (para um cliente não bloqueado) é criada.
\nEvento disparado sempre que uma correspondência para um cliente bloqueado é criada.
\nEvento disparado sempre que uma correspondência para um cliente bloqueado é criada.
\nEvento disparado quando uma correspondência é entregue presencialmente.
\nEvento disparado quando uma correspondência é encaminhada para o endereço do cliente.
\nEvento disparado quando uma correspondência é enviada por e-mail.
\nEvento disparado quando um cliente potencial é cadastrado.
\nEvento disparado quando um cliente potencial é editado.
\nEvento disparado quando um cliente potencial é excluído.
\nEvento disparado quando um contrato é cadastrado.
\nEvento disparado quando um contrato é editado.
\nEvento disparado quando um contrato é encerrado.
\nEvento disparado quando um contrato é reajustado.
\nEvento disparado quando um contrato é enviado para ser assinado.
\n