Visit www.talkable.com

Shopify Integration

Automatic integration

Note

If you have previously integrated with Talkable, make sure you remove the manual Talkable integration script located in the Additional Content & Scripts section before you start the Automatic integration process. See Manual integration for details.

  1. Create Talkable account at https://admin.talkable.com/register?object_or_array

- Provide a valid Shopify store URL. Example: http://123test.myshopify.com.
- Choose “Shopify” as your platform during registration process

  1. On the Welcome screen click “I’m a Developer”
  2. Click Install Shopify App
  3. You will be redirected to your Shopify store, log in and click the install button
  4. After successful installation you will be redirected back to Talkable
  5. Create, set up, and launch Campaigns (Invite, Advocate Dashboard, etc.)
  6. Verify your integration using Verifying Integration instructions.

Note

Post Purchase campaign is located at the “Thank you” page after Checkout.

To check how Standalone Campaign looks visit /pages/share or /pages/invite links of your store. You can edit these links in Administrative panel of your store.

Manual integration

  1. In your Shopify administration panel, go to SettingsCheckout & Payment.

  2. Under Order ProcessingAdditional Content & Scripts, insert this code:

    Note

    To get your personal integration code, YOUR-TALKABLE-SITE-ID needs to be replaced with your Talkable Site ID. You can get this from your Talkable dashboard after you log in and create a site.

    <!-- Begin Talkable integration code -->
    <script type="text/javascript">
      window._talkableq = window._talkableq || [];
      _talkableq.push(['init', {site_id: "YOUR-TALKABLE-SITE-ID"}]); /* REQUIRED - Replace with your Talkable Site ID */
    
      if (Shopify && Shopify.checkout) {
        checkout = Shopify.checkout
        var _talkable_order_items = [];
        for (idx in checkout.line_items) {
          line = checkout.line_items[idx];
          _talkable_order_items.push({
            product_id: line.sku || line.product_id, /* REQUIRED - First Item Product ID */
            price: line.price, /* REQUIRED - First Item Unit Price */
            quantity: line.quantity, /* REQUIRED - First Item Quantity */
            title: line.title, /* Optional - Name of product */
          });
        }
    
        var _talkable_data = {
          purchase: {
            order_number: checkout.order_id, /* REQUIRED - Order number */
            subtotal: checkout.total_price, /* REQUIRED - Purchase Subtotal */
            coupon_code: checkout.discount ? checkout.discount.code : null,
            items: _talkable_order_items
          },
          campaign_tags: ['post-purchase'],
          customer: {
            email: checkout.email, /* REQUIRED - Customer Email Address */
            first_name: checkout.billing_address ? checkout.billing_address.first_name : null, // Optional - Customer first name
            last_name: checkout.billing_address ? checkout.billing_address.last_name : null // Optional - Customer last name
          }
        };
    
        if (checkout.shipping_address) {
          shipping_address = checkout.shipping_address;
          shipping_fields = ['address1', 'address2', 'city', 'province', 'zip', 'country'];
          address = [];
    
          for (var idx in shipping_fields) {
            address_key = shipping_fields[idx];
            if (shipping_address[address_key]) {
              address.push(shipping_address[address_key]);
            }
          }
    
          if (shipping_address.zip) {
            _talkable_data.purchase.shipping_zip = shipping_address.zip;
          }
          if (address.length) {
            _talkable_data.purchase.shipping_address = address.join(', ');
          }
        }
    
        _talkableq.push(['register_purchase', _talkable_data]);
      }
    </script>
    <script async src="//d2jjzw81hqbuqv.cloudfront.net/integration/talkable-4.0.1.min.js" type="text/javascript"></script>
    <!-- End Talkable integration code -->
    
  3. Click Apply these settings.

  4. Verify your integration using Verifying Integration instructions.