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

      • Integrate Ticto

      Create an incoming integration in Clickmax, paste the Token Ticto generates for the webhook and register the Clickmax URL in Ticto's webhooks — from then on every event with an email creates or updates a contact (tagged ticto), while approved sales are recorded as sales in Clickmax.

      Before you start

      • Workspace role: Owner, Admin, Editor or Collaborator. The Finance, Guest and Agent roles have no access to Integrations.
      • Plan:
      • In Ticto you need access to Tictools > Webhooks.
      • You do not need to request API credentials from Ticto. This integration runs on webhooks alone.

      Step by step

      1. In Clickmax, open Integrations and pick the Ticto card.
      2. In another tab, go to Ticto and log in.
      3. In Ticto, open Tictools > Webhooks, click the eye icon of the folder where you want the webhook, then click + Add.
      4. Copy the Token Ticto shows and paste it into the Token field in Clickmax. This token is what proves the events came from Ticto — do not share it.
      5. Enter a Nickname for the integration and click Create integration.
      6. Clickmax generates a webhook URL. Copy it and paste it into the URL field in Ticto.
      7. Under Version, select 2.0.
      8. Under Delivery format, choose JSON. Under Items to send, choose Send Order Bump / Combo together with the main offer.
      9. Select the products and the events you want to receive, then click Save.
      10. Go back to Clickmax and click Complete integration.
      Warning

      Version 1.0 does not send order bumps or subscription data. If you leave it on 1.0 the integration connects, but orders with more than one product arrive incomplete and subscription triggers never fire. Use 2.0.

      On save, Ticto sends a test to the URL and only stores the webhook if it passes. If the test fails, confirm you pasted the full URL.

      What starts arriving

      Every event with an email creates or updates a contact tagged ticto. Approved sales mark the contact as a customer and record the sale; refunds, chargebacks and refused sales update the sale already recorded. Events without a customer email are ignored.

      Event in TictoTrigger in Clickmax
      Cart abandonmentCart abandoned
      Sale completedSale approved
      Awaiting paymentAwaiting payment
      Sale refusedSale refused
      RefundRefund
      ChargebackChargeback
      ClaimedPurchase claimed
      ClosedOrder closed
      Bank slip printedBank slip issued
      Bank slip overdueBank slip overdue
      Pix generatedPix generated
      Pix expiredPix expired
      Trial periodProduct trial ended
      [Subscription] Trial startedSubscription trial started
      [Subscription] Trial endedSubscription trial ended
      [Subscription] CanceledSubscription canceled
      [Subscription] OverdueSubscription overdue
      [Subscription] ResumedSubscription resumed
      [Subscription] ExtendedSubscription extended
      [Subscription] Card updatedCard updated
      [Subscription] EndedSubscription completed

      The Affiliation events (created, requested, approved) are not supported yet.

      Claimed and Closed become triggers and history entries, but they do not change the sale amount: neither one confirms that money moved.

      Orders with more than one product

      An order with an order bump or combo produces one sale in Clickmax, carrying the order total — not one sale per product. In the external sales list the main product shows a +N badge for the additional items.

      In the contact history it is the opposite: you get one activity per product, each with that item's amount, and the ones Ticto sends as order bumps get an Order bump badge.

      In flows, a trigger filtered by product fires when that product is in the order — including when it came in as an order bump.

      Note

      This only applies if you chose Send Order Bump / Combo together with the main offer in step 8. With the other option Ticto sends a separate event per item, and each one is treated as a single-product order.

      Filter by product

      Triggers let you pick a product. The list shows the Ticto products Clickmax already knows about — they show up on their own as webhooks arrive, and you can also add one manually by entering the Ticto product id.

      The filter matches on the product id, so renaming the product in Ticto does not break the trigger.

      If it didn't work

      • Ticto won't let me save the webhook: its automatic test could not reach the URL. Confirm you pasted the whole URL generated by Clickmax, with no trailing spaces.
      • No events arrive: check that the Token shown by Ticto was pasted into the integration — without it Clickmax rejects the deliveries. Also check that the events are selected in the webhook. See the FAQ.
      • Orders arrive with a single product: the webhook is on version 1.0 or set to send items separately. Set Version to 2.0 and Items to send to send them together with the main offer.
      • Subscription triggers never fire: version 1.0 does not send subscription data. Switch to 2.0.
      • Cart abandonment never arrives: Ticto only fires that event when the email or phone was filled in at checkout.
      • One specific event never arrives: events without the customer email are discarded (Clickmax cannot resolve the contact). Ticto's delivery history shows failures and the server response under Event details. See the error codes.