Yotpo

introduction this document will walk through integrating chord's oms with yotpo once you integrate, your customers will be able to use a powerful data driven tools that makes it very easy for your customers to provide their feedback so you can transform every purchase made into a review what is yotpo the yotpo destination function is used to sync completed orders from the chord's oms platform to yotpo to be able to collect higher quality reviews addressing high converting topics that actually inspire purchases and grow your business for more information about yotpo and custmizing the request flows please refer to their document https //support yotpo com/en/article/creating a review request premium enterprise creating the function before starting the creation of the function ensure that you are using the correct code template there are two different code templates for https //github com/chordcommerce/segment functions/blob/main/destinations/yotpo autonomy/index js vs https //github com/chordcommerce/segment functions/blob/main/destinations/yotpo performance/index js customers it is important to choose the right one copy the correct code navigate to segment and click catalog > functions > new function select "destination function" and click build paste in the function code from above and click settings add setting label = apikey name = apikey unanmed = \<apikey> (found in yotpo settings) click add setting label = secretkey name = secretkey unamed = \<secretkey> (found in yopto settings) click add setting label = secretkey name = secretkey unamed = \<secretkey> (found in yopto settings) click array in the first item event field paste order completed remove second and third item fields click add setting click configure provide a name, we recommend yotpo function provide a description, and even a logo and click create function connect function to source your function has been created! click connect destination for autonomy customers, the destination function should be connected to the ruby back end source for performance customers, the destination function should be connected to the javascript front end source when you connect the destination function, you'll need to provide values for the settings you configured above select your destination and click next provide a destination name, we recommend something like "yotpo production" click save enter the yotpo api key and secret key (found in the yotpo admin), and order completed for the events setting make sure to enable the function verify your function you can test that the function is working correctly in the "event tester" tab you'll need an example event, so find (or place a test order) a recent order completed event in the segment debugger for the source that you connected to the yotpo function, and copy the entire event json from the "raw" tab navigate to the "event tester" tab of the yotpo destination function you just created, and replace the dummy json with the event json you copied the order from the order completed event you copied will be synced to yotpo, so if yotpo is configured to send automatic review requests, the customer will receive one hit "send event" and make sure you see a 200 verify api order if you would like to query the yotpo api to see what orders have been submitted from the function, here's how get an access token populate the api key and the secret key in the code snippet curl request post \ curl request post \ url https //api yotpo com/core/v3/stores/api key/access tokens \ url https //api yotpo com/core/v3/stores/api key/access tokens \ header 'accept application/json' \ header 'accept application/json' \ header 'content type application/json' \ header 'content type application/json' \ data '{ "secret" "secret key" }' data '{ "secret" "secret key" }' copy the access token from the output and use it in the next step get the list of orders populate the api key and the token (from access token above) in the code snippet curl request get \ curl request get \ url https //api yotpo com/core/v3/stores/api key/orders \ url https //api yotpo com/core/v3/stores/api key/orders \ header 'accept application/json' \ header 'accept application/json' \ header 'content type application/json' \ header 'content type application/json' \ header 'x yotpo token token' header 'x yotpo token token' you should get a json list of orders from yotpo your connection is now successfully created!