Check the complete list of parameters and responses of the
POST Emit event
What is an event?
A Customer Event is any action performed by a customer that can activate certain behavior-based campaigns. For instance, events can include actions like completing a purchase, submitting a survey, or registering on your platform. You can send different types of events to Masivo, which will monitor them and apply your configured rules to distribute rewards through campaigns. However, only events that match the campaign’s specific criteria will successfully trigger those campaigns.Emit an Event
When emitting an event, the customer, brand, and event type must be defined and included in the request. The other values are optional, depending on the nature of the event to be emitted.Fulfill an event
If thefulfilled
attribute has been sent as false
in the body of the POST Emit event endpoint,
the event will be placed in a standby state. The reward won’t be added to the wallet until fulfilled
is true
.
It is important to note that when the event was not emitted with
fulfill
set to true
, the rewards will not be redeemed until it is explicitly fulfilled.It is also worth mentioning that the event will expire after 24 hours (by default depending on reserve
value) if it has not been set to fulfill.Reverse an event
If you want to reverse an event and all actions resulting from it, you must send the event id to thePOST Reverse event
endpoint, including a reason in the body of the request.
It is important to note that once an event has been reversed, its
STATUS
will change to "REVERSED"
.What happens when an event expires?
An event expires when it’s hasn’t been sent withfulfill
in true
and it’s been 24 hours since that.
The amount of days for expiration time can be extended by sending reserve
in the body of the request.
What happens if the event is reversed when is still unfulfilled?
If an event is emitted withfulfill
in false
and then it is reversed, the event will be cancelled. The status
in the response of the request will be set in "CANCELLED"
.
How reserves can be extended?
The reserve days can be extended by setting thereserve
attribute in the body
of the POST Emit event
endpoint. So the value sent in reserve
will be equal to the number of days the reserves will be extended.