Contacts & CRM

Contact source tracking

2 minutes read time Difficulty: beginner

Contact source tracking

Know where your contacts come from to measure which channels drive the most leads.

How source tracking works

When a contact is created, AIsoule automatically records the source:

SourceWhen it's set
whatsapp_webhookCustomer messages you first on WhatsApp
manualYou create the contact manually
importImported from CSV file
apiCreated via REST API
campaign_replyCustomer replied to a campaign message
flowCreated by a chatbot flow
adCame from a Click-to-WhatsApp ad

Viewing a contact's source

Open any contact — the Source field shows where they came from, along with optional source_detail for more context.

Filtering by source

  1. Go to Contacts
  2. Use the filter/search
  3. Filter by source type

Or create a segment: "Source equals ad" → All contacts from ads.

Using source data

Measure channel effectiveness

  • How many contacts from ads vs organic?
  • Which source has the highest conversion rate?
  • Where should you invest more?

Personalize outreach

  • Contacts from ads → Send product-specific follow-up
  • Contacts from support → Send satisfaction survey
  • Contacts from import → Send welcome sequence

Tips

  1. Track from day one — Source data can't be backfilled
  2. Use with segments — Create segments per source for targeted campaigns
  3. Review monthly — See which channels are growing
  4. Attribute correctly — If using multiple ad campaigns, use source_detail to differentiate

Was this guide helpful?

Your feedback helps us make these guides better for everyone.