How can we help?

Send customer attributes and events

Updated

Talvo has a built-in customer data platform. Stream your own customer traits and product events in with two REST endpoints; they appear on the contact and power segments and the churn and upsell radar.

Identify — set traits

Send a customer's attributes with POST /v1/identify:

  • Include an email, plus any custom attributes (plan, mrr, seats, signed_up, and so on).
  • The keys you send are stored and shown exactly as you send them. Talvo does not rename, normalize or interpret them.
  • Sending the same email again updates that contact rather than creating a second one.

Send attributes whenever they change, not just at signup. A plan that is six months stale is worse than no plan at all, because your team will trust it.

Track — record events

Record product events with POST /v1/track:

  • Include the email, an event name such as upgraded_plan, and optional metadata.
  • Events build a per-contact timeline your agents see at a glance.

Shown with our demo workspace.

Pick a small, stable set of event names and stick to them. upgraded_plan, Upgraded Plan and plan_upgraded are three different events, and the timeline will show all three.

Why it is worth doing

Attributes and events are what turn a support conversation into an informed one. An agent opening a thread sees the plan, the seat count and that the customer hit a limit twenty minutes ago — without asking, and without switching to another tool.

They also feed the churn and upsell radar, which can only reason about signals you actually send.

Authentication

Both endpoints authenticate with your workspace API key. Copy-paste examples are in Settings → Developers.

Was this article helpful?