Transitioning from v2 to v4
A guide for transitioning from using v2 of our message queuing to v4.
Last updated
Was this helpful?
A guide for transitioning from using v2 of our message queuing to v4.
Last updated
Was this helpful?
In coordination with the messaging updates, we are launching v4 of our API. Since the changes to the object structures in our messages are consistent with the changes made to response objects on the API side, we opted to skip a version 3 release of the messaging infrastructure and instead keep the version numbers in lock step between the features.
Rightsline messaging v4 enables customers to manage their own subscriptions to our SNS topics. You will need to provide us with your AWS account ID as well as the char types that you would like to receive messages for (e.g. Deals, Catalog Items, etc.), and we will provide your personalized SNS topic ARNs. Using your AWS account, you can create subscriptions to these topics to trigger custom logic using AWS Lambda, populate a queue using AWS SQS, or call an external HTTP endpoint for some downstream system.
In order to create a subscription to your SNS topics, access the .
Select Subscriptions, and click Create Subscription.
Under Topic ARN, input the provided SNS topic ARN. Select the protocol where you would like the message delivered.
Under Subscription filter policy, add any filters that you would like to your subscription. You can filter on any message attribute value. See .
Removed entityUrl, rootEntityUrl, parentUrl, childUrl properties. These properties have been replaced with entity objects, with the names entity, rootEntity, parentEntity, childEntity. The entityId, charTypeId, template, and status have all been moved inside the entity object. The workflow processId and processName have been added to the template object.
statusUpdatedById, statusUpdatedDate have been added to all entity messages.
relationshipType object has been added to relationship messages.
Rightsline will provide an ARN that you will need to assume in order to interact with the messages on the SNS topic. Using this role, you will be able to retrieve credentials that will give you access to receive messages from your SNS topics. For more information, see .
We have added additional message attributes to all of our messages to allow more precise filtering of messages. For all message attributes, see .
We have redesigned the structure of our messages to provide more information about the event. For complete examples, see . Some of the specific changes are:
We have removed the action-executed SNS topics. Workflow action event messages will now be sent to the relevant char type SNS topic, with an action value of action-executed. For instance, if a workflow action is taken on a deal, you will receive a message to the deal (ct4) SNS topic. An example action-executed message can be found .
