Messaging preferences
Each user has the following agentic messaging preferences.Message style
Message style sets what kind of messages a user wants, on a scale from 1 to 5. In the API, it’s calledtemperature.
- 1, essentials and direct: only the messages that matter most to the user, like their own progress, kept short and to the point.
- 3: the default.
- 5, everything and conversational: the full range of messages agents can send, in a more conversational tone.
Promotional messages
Whether the user wants to hear about promotions, like offers and announcements. Users who turn promotional messages off still get messages about their own progress in your app.Channels
The channels agents may use for this user,email and/or push. Both are on by default. An empty list turns agentic messages off for the user.
Hosted preferences page
Every agentic email links to a preferences page hosted by Trophy, where users can set their own preferences:- What kind of messages do you like?: a slider from Essentials, direct to Everything, conversational that sets the user’s message style.
- Promotional messages: a toggle to turn promotions on or off.
- Unsubscribe from all: a toggle to stop all emails. Turning it back off resubscribes the user.
Building your own preference center
To let users manage their preferences inside your app, use the get a user’s preferences and update a user’s preferences endpoints. Agentic messaging preferences are in themessaging object:
Who receives agentic messages
Each user receives either agentic messages or legacy emails and push notifications, never both. Which one a user gets depends on your rollout. You can check which one applies to a user with theagenticMessagingEnabled field on the user object, returned by the get a single user endpoint. It’s true for users receiving agentic messages.
Users in your control group receive no messages from Trophy at all, so their agenticMessagingEnabled field is always false.