Skip to content

Segment

Stream events from Segment into JustAI so your experiments can measure conversions and custom events.

  1. You add a Webhooks (Actions) destination in Segment that forwards your chosen events to JustAI’s webhook endpoint.
  2. JustAI joins those events with the messages each user received to measure results.
  • Your JustAI org slug — usually your company name in lowercase (ask us if you’re not sure).
  • A JustAI API key — create one in the JustAI Console.
  1. Log in to Segment.

  2. Navigate to “Destinations” and click “Add destination”.

    Step 1

  3. Choose “Webhooks (Actions)”.

    Step 2

  4. Click “Add destination”.

    Step 3

  5. Select a data source, set the “Destination name” to “JustAI Webhook”, and leave the dropdown menu as “Fill in settings manually”.

    Step 4

  6. Choose “Create destination”.

  7. Set a “Shared Secret” using your JustAI API key.

    Step 5

  8. Click “New Mapping” in the Mappings tab.

    Step 6

  9. Set up a mapping and define the event trigger. The most open-ended option is “Event Type”, but you can narrow it down to specific events.

    Step 7

  10. Configure the mapping settings:

    • Set the destination URL to https://worker.justwords.ai/api/webhook/segment/<org_slug>
    • Set the method to POST
    • Set the Headers to “X-Api-Key” with your JustAI API key as the value
    • Set the Batch Size to 1000 (a reasonable starting point — adjust based on your source’s data volume, and ask us if you’re not sure)

    Step 8

  11. Press “Next”, then save and enable the webhook.

    Step 9

  12. Under Settings, toggle “Enable Destination” and click “Save Changes”.

    Step 10

After some time, you should start seeing traffic to the destination in Segment.

Step 11