Webhook
Criação, organização e gerenciamento de webhooks na Ticto
🌐 Webhooks – Tictools
Índice
O que são Webhooks
Visão Geral do Menu Webhook
Pastas
Documentação Oficial
Lista de Webhooks
Ações Disponíveis
Como Criar um Webhook
Token
Itens a serem enviados
Produtos
URL
Versão
Formato de Envio
Seleção de Eventos
Eventos Disponíveis (Tabela Completa)
Validação Automática da URL
Observações Importantes
🔔 O que são Webhooks
Webhooks são mecanismos que enviam notificações em tempo real para outros sistemas quando um evento ocorre na plataforma.
Eles permitem:
Integrar automações externas ( sistemas de automatização de conversas, áreas de membros externas, entre outros)
Sincronizar dados imediatamente
Acompanhar eventos de vendas, assinaturas, afiliações e pagamentos
Como acessar a funcionalidade de webhoooks
Siga o passo a passo abaixo:
Abra o menu lateral esquerdo da plataforma, clique na opção Tictools
Dentro de Tictools, clique no card Webhooks
🧭 Visão Geral do Menu Webhook
O menu Tictools → Webhooks permite que você:
Criar Webhooks
Configurar URLs e eventos para notificações
Organizar em Pastas
Agrupar webhooks por categoria
Testar Webhooks
Enviar um evento de teste
Acompanhar Envios
Ver histórico de disparos
Editar / Excluir
Gerenciar webhooks existentes
🗂 Pastas
O usuário pode criar pastas para organizar webhooks.
Nova Pasta
Cria uma nova pasta para agrupar webhooks
Nome personalizado
Pasta pode receber qualquer nome
Organização
Permite separar webhooks por sistema, produto ou equipe
Para criar uma para e organizar os webhooks por projetos ou produtos, siga o passo a passo:
Ainda dentro do menu tictools/webhooks, clique no botão "+nova pasta"
Depois insira o nome do projeto que desejar
Após digitar o nome do projeto, clique em "salvar"
Após salvar, você visualizará uma mensagem sinalizado que a pasta foi criada com sucesso. As pastas aparecerão na lateral esquerda, você pode acessar as pasta para visualizar as integrações ou até mesmo adicionar uma nova.
📚 Documentação Oficial
O menu inclui um link direto para a documentação técnica completa dos Webhooks.
Use a documentação para integrar corretamente com sistemas externos.
📋 Lista de Webhooks
A tabela de webhooks exibe:
URL
Endereço para onde os eventos serão enviados
Pasta
Categoria onde o webhook está organizado
Produto
Produto(s) relacionado(s) ao webhook
Versão
Versão 1.0 (legado) ou 2.0 (recomendada)
Eventos
Eventos selecionados para envio
🛠 Ações Disponíveis
Cada webhook possui um menu com:
Editar
Modificar URL, eventos, versão ou pasta
Enviar evento de teste
Envia um payload para validar a integração
Visualizar envios
Histórico de disparos (sucessos e falhas)
Excluir
Remove o webhook permanentemente
➕ Como Criar um Webhook
A criação envolve alguns passos importantes, veja a seguir:
Através do menu lateral direito tictools/webhooks, clique sobre o ícone de olho, referente a pasta em que deseja criar o webhook.
Depois clique em no botão "+adicionar"
🧱 Itens a serem enviados
Esta seleção determina se os itens de order bump/combo, devem ser enviados junto ao payload do produto principal ou separados.
Caso opte pela opção Enviar Order Bump | Combo separadamente, você receberá payloads individuais para cada item.
Enviar Order Bump / Combo junto com a oferta principal
Envia tudo em um único evento
Para integrações que preferem dados unificados
Enviar Order Bump / Combo separadamente
Envia eventos distintos
Para sistemas que tratam cada item individualmente
📤 Formato de Envio
Este formato define como a resposta chegará na sua url, o modelos mais utilizado é JSON.
JSON
Padrão mais moderno e estruturado
✔️ Recomendado
URL Codificado
Envia dados como querystring
Necessário para fornecedores como Notazz
Alguns fornecedores (como Notazz) precisam de um formato de envio diferente Para estes casos, você pode escolher o mais adequado.
📤 Selecione os eventos
Os eventos são os gatilhos responsáveis por enviar as informações para url configurada. Assim que um dos eventos selecionados acontecerem será enviado uma resposta com os dados da venda, assinatura, abandono de carrinho etc. A seguir, a tabela organizada por categorias:
🛒 Eventos de Compra
1. Abandono de Carrinho
Cliente inicia compra, mas não finaliza
Recuperação de vendas
2. Boleto Impresso
Cliente visualiza/emite boleto
Lembretes antes do vencimento
4. Pix Gerado
Pix criado
Acompanhar intenção de compra
18. Pix Expirado
Pix expirou sem pagamento
Oferta de novo link
15. Venda Realizada
Pagamento aprovado
Ativar acessos, processamento
19. Venda Recusada
Pagamento falhou
Solicitar novo método
20. Aguardando Pagamento
Venda criada, aguardando compensação
Fluxos de espera
16. Boleto Atrasado
Boleto venceu sem pagamento
Recuperação de vendas
17. Encerrado
Operação do boleto finalizada
Encerramento de fluxo
💳 Eventos de Assinatura
7. Encerrada
Assinatura finalizada
Comunicação de encerramento
8. Extendida
Cliente prolonga assinatura
Manter serviço ativo
9. Atrasada
Pagamento não compensado
Solicitar atualização
10. Período de Testes Encerrado
Teste finalizado
Notificar conversão/cobrança
11. Período de Testes Iniciado
Teste começou
Onboarding
12. Cancelada
Assinatura encerrada pelo cliente
Retenção/cancelamento de acesso
13. Cartão Atualizado
Cliente alterou cartão
Evitar falhas futuras
14. Retomada
Assinatura reativada
Reativar acessos
🤝 Eventos de Afiliação
21. Afiliação Criada
Nova solicitação registrada
Analisar novo afiliado
22. Afiliação Solicitada
Produtor deve aprovar
Processo de aprovação
23. Afiliação Aprovada
Afiliação aceita
Afiliado liberado para promover
🧾 Eventos Especiais
3. Chargeback
Contestação do pagamento
5. Reembolso
Cliente recebeu reembolso
6. Tempo de Teste
Teste de produto finalizado
🔍 Validação Automática da URL
Ao cadastrar uma URL, a Ticto envia um teste automático antes de permitir salvar.
✔️ Caso o teste seja bem-sucedido:
Modal informa sucesso
Usuário pode salvar normalmente
❌ Caso falhe:
Mensagem explica o erro
Usuário deve ajustar a URL antes de continuar
💡 Essa validação evita erros de configuração e falhas de integração.
Criamos uma situação simples para que vejam na prática essa validação. Para o exemplo abaixo criamos uma url de teste através do site : https://webhook.site/#!/view/b6126fc7-c779-4802-81e6-e73b4a7ca512
Configuramos os eventos:
Confirme se está tudo ok com a configuração e clique em Salvar.
Reposta do disparo do evento:
📌 Observações Importantes
O histórico de envios mostra falhas e sucessos.
Eventos como Carrinho Abandonado só disparam quando e-mail ou telefone foram preenchidos.
Versão 2.0 oferece payloads mais completos e padronizados.
É possível ver os detalhes e resposta do servidor através do Detalhes do evento.
É possivel reenviar um evento através do relatório de minhas vendas.
Atualizado
Isto foi útil?