For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/integrations/ticto.md.
  • Português
  • Integrar Ticto

    Crie uma integração de entrada na Clickmax, cole o Token que a Ticto gera para o webhook e registre a URL da Clickmax nos webhooks da Ticto — e cada evento com e-mail passa a criar ou atualizar um contato (com a tag ticto), enquanto as vendas aprovadas viram vendas na Clickmax.

    Antes de começar

    • Papel de workspace: Proprietário, Administrador, Editor ou Colaborador. Os papéis Financeiro, Convidado e Atendente não têm acesso a Integrações.
    • Plano:
    • Na Ticto você precisa de acesso a Tictools > Webhooks.
    • Não é preciso pedir credencial de API à Ticto. A integração funciona apenas com webhooks.

    Passo a passo

    1. Na Clickmax, abra Integrações e selecione o card Ticto.
    2. Em outra aba, acesse a Ticto e faça login.
    3. Na Ticto, abra Tictools > Webhooks, clique no ícone de olho da pasta em que quer criar o webhook e depois em + Adicionar.
    4. Copie o Token que a Ticto exibe e cole no campo Token da Clickmax. Esse token é o que comprova que os eventos vieram da Ticto — não compartilhe.
    5. Informe um Apelido para a integração e clique em Criar integração.
    6. A Clickmax gera uma URL de webhook. Copie essa URL e cole no campo URL na Ticto.
    7. Em Versão, selecione 2.0.
    8. Em Formato de Envio, escolha JSON. Em Itens a serem enviados, escolha Enviar Order Bump / Combo junto com a oferta principal.
    9. Selecione os produtos e os eventos que quer receber e clique em Salvar.
    10. Volte à Clickmax e clique em Concluir integração.
    Warning

    A versão 1.0 não envia os order bumps nem os dados de assinatura. Se você deixar 1.0, a integração conecta, mas os pedidos com mais de um produto chegam incompletos e os gatilhos de assinatura não disparam. Use 2.0.

    Ao salvar, a Ticto envia um teste para a URL e só grava o webhook se ele passar. Se o teste falhar, confirme que colou a URL completa.

    O que passa a chegar

    Cada evento com e-mail cria ou atualiza um contato com a tag ticto. Vendas aprovadas marcam o contato como cliente e registram a venda; reembolso, chargeback e venda recusada também atualizam a venda já registrada. Eventos sem e-mail do cliente são ignorados.

    Evento na TictoGatilho na Clickmax
    Abandono de CarrinhoCarrinho abandonado
    Venda RealizadaVenda realizada
    Aguardando PagamentoAguardando pagamento
    Venda RecusadaVenda recusada
    ReembolsoReembolso
    ChargebackChargeback
    ReclamadoCompra reclamada
    EncerradoPedido encerrado
    Boleto ImpressoBoleto impresso
    Boleto AtrasadoBoleto atrasado
    Pix GeradoPix gerado
    Pix ExpiradoPix expirado
    Tempo de TesteTempo de teste
    [Assinatura] Período de Testes IniciadoPeríodo de testes iniciado
    [Assinatura] Período de Testes EncerradoPeríodo de testes encerrado
    [Assinatura] CanceladaAssinatura cancelada
    [Assinatura] AtrasadaAssinatura atrasada
    [Assinatura] RetomadaAssinatura retomada
    [Assinatura] ExtendidaAssinatura estendida
    [Assinatura] Cartão atualizadoCartão atualizado
    [Assinatura] EncerradaAssinatura encerrada

    Os eventos de Afiliação (criada, solicitada, aprovada) ainda não são suportados.

    Reclamado e Encerrado viram gatilho e atividade no histórico, mas não alteram o valor da venda: nenhum dos dois confirma movimento de dinheiro.

    Pedido com mais de um produto

    Um pedido com order bump ou combo gera uma venda na Clickmax, com o valor total do pedido — não uma venda por produto. Na lista de vendas externas o produto principal aparece com um selo +N indicando os itens adicionais.

    No histórico do contato é o contrário: entra uma atividade por produto, cada uma com o valor daquele item, e os que a Ticto envia como order bump ganham o selo Order bump.

    Nos fluxos, o gatilho filtrado por produto dispara se aquele produto estiver no pedido — inclusive quando ele veio como order bump.

    Note

    Isso só vale se você escolheu Enviar Order Bump / Combo junto com a oferta principal no passo 8. Na outra opção a Ticto manda um evento separado para cada item, e cada um é tratado como um pedido de produto único.

    Filtrar por produto

    Nos gatilhos você pode escolher um produto. A lista mostra os produtos da Ticto que a Clickmax já conhece — eles aparecem sozinhos conforme os webhooks vão chegando, e você também pode adicionar um manualmente informando o id do produto na Ticto.

    O filtro casa pelo id do produto, então renomear o produto na Ticto não quebra o gatilho.

    Relacionados

    Se não funcionou

    • A Ticto não deixa salvar o webhook: o teste automático dela não alcançou a URL. Confirme que colou a URL inteira gerada pela Clickmax, sem espaços no fim.
    • Nenhum evento chega: confira se o Token exibido pela Ticto foi colado na integração — sem ele a Clickmax rejeita as entregas. Confira também se os eventos foram marcados no webhook. Veja as perguntas frequentes.
    • Os pedidos chegam com um produto só: o webhook está na versão 1.0 ou na opção de enviar os itens separadamente. Ajuste Versão para 2.0 e Itens a serem enviados para enviar junto com a oferta principal.
    • Os gatilhos de assinatura não disparam: a versão 1.0 não envia os dados de assinatura. Troque para 2.0.
    • Carrinho abandonado não chega: a Ticto só dispara esse evento quando o e-mail ou o telefone foi preenchido no checkout.
    • Um evento específico não chega: eventos sem o e-mail do cliente são descartados (a Clickmax não consegue resolver o contato). O histórico de envios da Ticto mostra as falhas e a resposta do servidor em Detalhes do evento. Veja os códigos de erro.