Webhooks no IXC Assina
Visão geral
A aba Webhooks no IXC Assina permite exibir os endpoints responsáveis por receber notificações automáticas sobre eventos gerados em integrações com sistemas de gestão. Cada webhook atua como um canal de comunicação em tempo real, enviando dados de eventos — como status de documentos, criação de contratos ou assinaturas concluídas — diretamente para o sistema externo configurado. Um webhook é criado no IXC Assina sempre que uma integração com o IXC Oner ou IXC Oner é criada.
Definição de Webhook
Um Webhook é um mecanismo automático de envio de informações de um sistema para outro assim que um evento acontece.
Como acessar
Caminho: Configurações > Integrações > Webhooks
Estrutura e componentes da aba de Webhooks
A aba Webhooks concentra as conexões entre o IXC Assina e sistemas externos, focada em receber os eventos da integração. Nesta aba é possível:
- Acompanhar o status das integrações existentes;
- Visualizar dados do Webhook;
- Excluir Webhooks;
A interface é composta pelos componentes:
| Componentes | Descrição |
|---|---|
| Botão de atualização | Atualiza a listagem de webhooks, útil para sincronizar dados recém-criados ou modificados. |
| Lista de Webhooks | Indica ausência de dados com texto informativo e ilustração, reforçando que os webhooks aparecerão assim que forem adicionados. |
| Ver logs | Abre o histórico de eventos e respostas do webhook selecionado, permitindo verificar o sucesso ou falha das notificações. |
| Editar | Permite alterar informações do webhook, como URL do endpoint, eventos monitorados e status de ativação. |
| Excluir | Remove o webhook da listagem de forma permanente, interrompendo o envio de notificações ao endpoint configurado. |
Navegação
flowchart TD A[Criar integração no IXC Assina] --> B[Configurar integração no sistema de gestão] B --> C[Criar Webhook no IXC Assina] C --> D[Receber eventos automáticos no sistema de gestão] D --> E[Acompanhar e gerenciar Webhooks]
Considerações
Os Webhooks no IXC Assina enviam notificações automáticas ao sistema de gestão sempre que um evento ocorre. Para funcionar, o ERP precisa ter um endpoint válido e acessível. Cada Webhook é vinculado a um workspace, separando ambientes de produção e sandbox. É possível acompanhar envios e falhas na aba Logs de Webhooks. Caso o endpoint falhe, o sistema tenta reenviar o evento automaticamente. Webhooks podem ser editados ou excluídos sem impactar as integrações existentes.