Chord Webhook Events App

overview when installed on your shopify store, chord sends tracking events from two sources your storefront , using either the chord shopify web pixel or @chordcommerce/analytics (see shopify installation docid 7ggdgpvq4j3qwbprhy1fr ) chord's server events service , which sends tracking events from a shopify webhook source in your chord workspace in response to webhook triggers from shopify when chord provisions your workspace, it includes a shopify webhook source/back end in the chord cdp this source listens for webhook events from shopify and transforms them into chord events step 1 create the app go to your shopify dev dashboard in the navigation menu, click apps → create app under start from dev dashboard , enter the app name chord webhook events click create step 2 configure access scopes leave the form settings as is in the api access section, paste the following scopes read all orders,read assigned fulfillment orders,read customers,read discounts,read fulfillments,read inventory,read locations,read merchant managed fulfillment orders,read orders,read product feeds,read product listings,read products,read reports,read returns,read shipping,read third party fulfillment orders click release step 3 install the app on the app home page, click install app select your store review the application scopes click install step 4 collect your credentials you can find the client credentials by visiting the app settings page you will need both the “client id” and “secret” you will also need your store url in the following format your store url myshopify com you can find your store url by visiting the store admin page the admin landing page url will look similar to the following https //admin shopify com/store/{{your store url}}/orders the portion of the url after store, is your store name that you will want to provide step 5 share your client credentials with chord team your app's client id & secret along with your store's shopify subdomain needs to be shared with the chord team these values will be used to finalize the creation & set up of server side events fired from shopify back end additional info supported webhook topics & events webhook topic chord event checkouts/create checkout created orders/create order completed refunds/create order refunded customers/delete customer deleted customers/merge customer merged locations/delete location deleted orders/delete order deleted products/delete product deleted verifying the installation to verify that server events are flowing correctly complete a test transaction in your shopify store in your chord workspace, navigate to the shopify webhook source (possibly referenced as the back end source) and open the live events tab confirm that the expected events (checkout created, order completed, etc ) appear subscription events if your store sells subscriptions, chord can also track subscription lifecycle events (creation, cancellation, payment failures, etc ) due to shopify platform restrictions, subscription events require a different setup using shopify flow see shopify subscription event tracking docid 3irbd314fqajoowdjv6ax for details associating server events with storefront sessions to link server events with front end storefront events from the same customer session, the storefront must save certain browser identifiers as attributes on the cart or order these identifiers are then retrieved by the webhook source and included in chord events for details, see unifying data across sources #