intercom 3.5.10 → 4.1.2

data/lib/intercom/version.rb

@@ -1,3 +1,3 @@
 module Intercom #:nodoc:
-  VERSION = "3.5.10"
+  VERSION = "4.1.2"
 end

data/lib/intercom/visitor.rb

@@ -8,7 +8,5 @@ module Intercom
 
     def identity_vars ; [:id, :email, :user_id] ; end
     def flat_store_attributes ; [:custom_attributes] ; end
-    def update_verb ; 'put' ; end
-
   end
 end

data/spec/spec_helper.rb

@@ -1,126 +1,243 @@
+# frozen_string_literal: true
+
 require 'intercom'
 require 'minitest/autorun'
 require 'mocha/setup'
+require 'webmock'
+require 'time'
+require 'pry'
+include WebMock::API
+
+def test_article
+  {
+      "id": "1",
+      "type": "article",
+      "workspace_id": "tx2p130c",
+      "title": "new title",
+      "description": "test Finished articles are visible when they're added to a Help Center collection",
+      "body": "<p>thingbop</p>",
+      "author_id": 1,
+      "state": "draft"
+  }
+end
+
+def test_updated_article
+  {
+      "id": "1",
+      "type": "article",
+      "workspace_id": "tx2p130c",
+      "title": "new updated title",
+      "description": "test Finished articles are visible when they're added to a Help Center collection",
+      "body": "<p>thingbop</p>",
+      "author_id": 1,
+      "state": "draft"
+  }
+end
+
+def test_user(email = 'bob@example.com')
+  {
+    'type' => 'user',
+    'id' => 'aaaaaaaaaaaaaaaaaaaaaaaa',
+    'user_id' => 'id-from-customers-app',
+    'email' => email,
+    'name' => 'Joe Schmoe',
+    'avatar' => { 'type' => 'avatar', 'image_url' => 'https://graph.facebook.com/1/picture?width=24&height=24' },
+    'app_id' => 'the-app-id',
+    'custom_attributes' => { 'a' => 'b', 'b' => 2 },
+    'companies' =>
+     { 'type' => 'company.list',
+       'companies' =>
+       [{ 'type' => 'company',
+          'company_id' => '123',
+          'id' => 'bbbbbbbbbbbbbbbbbbbbbbbb',
+          'app_id' => 'the-app-id',
+          'name' => 'Company 1',
+          'remote_created_at' => 1_390_936_440,
+          'created_at' => 1_401_970_114,
+          'updated_at' => 1_401_970_114,
+          'last_request_at' => 1_401_970_113,
+          'monthly_spend' => 0,
+          'session_count' => 0,
+          'user_count' => 1,
+          'tag_ids' => [],
+          'custom_attributes' => { 'category' => 'Tech' } }] },
+    'session_count' => 123,
+    'unsubscribed_from_emails' => true,
+    'last_request_at' => 1_401_970_113,
+    'created_at' => 1_401_970_114,
+    'remote_created_at' => 1_393_613_864,
+    'updated_at' => 1_401_970_114,
+    'user_agent_data' => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_3) AppleWebKit/535.11 (KHTML, like Gecko) Chrome/17.0.963.56 Safari/535.11',
+    'social_profiles' => { 'type' => 'social_profile.list',
+                           'social_profiles' => [
+                             { 'type' => 'social_profile', 'name' => 'twitter', 'url' => 'http://twitter.com/abc', 'username' => 'abc', 'id' => nil },
+                             { 'type' => 'social_profile', 'name' => 'twitter', 'username' => 'abc2', 'url' => 'http://twitter.com/abc2', 'id' => nil },
+                             { 'type' => 'social_profile', 'name' => 'facebook', 'url' => 'http://facebook.com/abc', 'username' => 'abc', 'id' => '1234242' },
+                             { 'type' => 'social_profile', 'name' => 'quora', 'url' => 'http://facebook.com/abc', 'username' => 'abc', 'id' => '1234242' }
+                           ] },
+    'location_data' =>
+    { 'type' => 'location_data',
+      'city_name' => 'Dublin',
+      'continent_code' => 'EU',
+      'country_name' => 'Ireland',
+      'latitude' => '90',
+      'longitude' => '10',
+      'postal_code' => 'IE',
+      'region_name' => 'Europe',
+      'timezone' => '+1000',
+      'country_code' => 'IRL' }
+  }
+end
 
-def test_user(email="bob@example.com")
-  {
-    "type" =>"user",
-    "id" =>"aaaaaaaaaaaaaaaaaaaaaaaa",
-    "user_id" => 'id-from-customers-app',
-    "email" => email,
-    "name" => "Joe Schmoe",
-    "avatar" => {"type"=>"avatar", "image_url"=>"https://graph.facebook.com/1/picture?width=24&height=24"},
-    "app_id" => "the-app-id",
-    "custom_attributes" => {"a" => "b", "b" => 2},
-    "companies" =>
-     {"type"=>"company.list",
-      "companies"=>
-       [{"type"=>"company",
-         "company_id"=>"123",
-         "id"=>"bbbbbbbbbbbbbbbbbbbbbbbb",
-         "app_id"=>"the-app-id",
-         "name"=>"Company 1",
-         "remote_created_at"=>1390936440,
-         "created_at"=>1401970114,
-         "updated_at"=>1401970114,
-         "last_request_at"=>1401970113,
-         "monthly_spend"=>0,
-         "session_count"=>0,
-         "user_count"=>1,
-         "tag_ids"=>[],
-         "custom_attributes"=>{"category"=>"Tech"}}]},
-    "session_count" => 123,
-    "unsubscribed_from_emails" => true,
-    "last_request_at" =>1401970113,
-    "created_at" =>1401970114,
-    "remote_created_at" =>1393613864,
-    "updated_at" =>1401970114,
-    "user_agent_data" => "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_3) AppleWebKit/535.11 (KHTML, like Gecko) Chrome/17.0.963.56 Safari/535.11",
-    "social_profiles" =>{"type"=>"social_profile.list",
-       "social_profiles" => [
-           {"type" => "social_profile", "name" => "twitter", "url" => "http://twitter.com/abc", "username" => "abc", "id" => nil},
-           {"type" => "social_profile", "name" => "twitter", "username" => "abc2", "url" => "http://twitter.com/abc2", "id" => nil},
-           {"type" => "social_profile", "name" => "facebook", "url" => "http://facebook.com/abc", "username" => "abc", "id" => "1234242"},
-           {"type" => "social_profile", "name" => "quora", "url" => "http://facebook.com/abc", "username" => "abc", "id" => "1234242"}
-       ]},
-   "location_data"=>
-    {"type"=>"location_data",
-     "city_name"=> 'Dublin',
-     "continent_code"=> 'EU',
-     "country_name"=> 'Ireland',
-     "latitude"=> '90',
-     "longitude"=> '10',
-     "postal_code"=> 'IE',
-     "region_name"=> 'Europe',
-     "timezone"=> '+1000',
-     "country_code" => "IRL"}
-  }
-end
-
-def test_user_dates(email="bob@example.com", created_at=1401970114, last_request_at=1401970113)
-  {
-      "type" =>"user",
-      "id" =>"aaaaaaaaaaaaaaaaaaaaaaaa",
-      "user_id" => 'id-from-customers-app',
-      "email" => email,
-      "name" => "Joe Schmoe",
-      "avatar" => {"type"=>"avatar", "image_url"=>"https://graph.facebook.com/1/picture?width=24&height=24"},
-      "app_id" => "the-app-id",
-      "custom_attributes" => {"a" => "b", "b" => 2},
-      "companies" =>
-          {"type"=>"company.list",
-           "companies"=>
-               [{"type"=>"company",
-                 "company_id"=>"123",
-                 "id"=>"bbbbbbbbbbbbbbbbbbbbbbbb",
-                 "app_id"=>"the-app-id",
-                 "name"=>"Company 1",
-                 "remote_created_at"=>1390936440,
-                 "created_at"=>1401970114,
-                 "updated_at"=>1401970114,
-                 "last_request_at"=>1401970113,
-                 "monthly_spend"=>0,
-                 "session_count"=>0,
-                 "user_count"=>1,
-                 "tag_ids"=>[],
-                 "custom_attributes"=>{"category"=>"Tech"}}]},
-      "session_count" => 123,
-      "unsubscribed_from_emails" => true,
-      "last_request_at" =>last_request_at,
-      "created_at" =>created_at,
-      "remote_created_at" =>1393613864,
-      "updated_at" =>1401970114,
-      "user_agent_data" => "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_3) AppleWebKit/535.11 (KHTML, like Gecko) Chrome/17.0.963.56 Safari/535.11",
-      "social_profiles" =>{"type"=>"social_profile.list",
-                           "social_profiles" => [
-                               {"type" => "social_profile", "name" => "twitter", "url" => "http://twitter.com/abc", "username" => "abc", "id" => nil},
-                               {"type" => "social_profile", "name" => "twitter", "username" => "abc2", "url" => "http://twitter.com/abc2", "id" => nil},
-                               {"type" => "social_profile", "name" => "facebook", "url" => "http://facebook.com/abc", "username" => "abc", "id" => "1234242"},
-                               {"type" => "social_profile", "name" => "quora", "url" => "http://facebook.com/abc", "username" => "abc", "id" => "1234242"}
-                           ]},
-      "location_data"=>
-          {"type"=>"location_data",
-           "city_name"=> 'Dublin',
-           "continent_code"=> 'EU',
-           "country_name"=> 'Ireland',
-           "latitude"=> '90',
-           "longitude"=> '10',
-           "postal_code"=> 'IE',
-           "region_name"=> 'Europe',
-           "timezone"=> '+1000',
-           "country_code" => "IRL"}
+def test_contact(email = 'bob@example.com', role = 'user')
+  {
+    'type' => 'contact',
+    'id' => 'aaaaaaaaaaaaaaaaaaaaaaaa',
+    'external_id' => 'id-from-customers-app',
+    'role' => role,
+    'email' => email,
+    'name' => 'Joe Schmoe',
+    'avatar' => { 'type' => 'avatar', 'image_url' => 'https://graph.facebook.com/1/picture?width=24&height=24' },
+    'workspace_id' => 'the-workspace-id',
+    'custom_attributes' => { 'a' => 'b', 'b' => 2 },
+    'companies' => {
+      'type' => 'list',
+      'data' =>
+             [{ 'type' => 'company',
+                'company_id' => '123',
+                'id' => 'bbbbbbbbbbbbbbbbbbbbbbbb',
+                'workspace_id' => 'the-workspace-id',
+                'name' => 'Company 1',
+                'remote_created_at' => 1_390_936_440,
+                'created_at' => 1_401_970_114,
+                'updated_at' => 1_401_970_114,
+                'last_request_at' => 1_401_970_113,
+                'monthly_spend' => 0,
+                'session_count' => 0,
+                'contact_count' => 1,
+                'tag_ids' => [],
+                'custom_attributes' => { 'category' => 'Tech' } }],
+      'url' => '/contacts/12345/companies'
+    },
+    'tags' => {
+      'type' => 'list',
+      'data' => [],
+      'url' => '/contacts/12345/tags'
+    },
+    'notes' => {
+      'type' => 'list',
+      'data' => [],
+      'url' => '/contacts/12345/notes'
+    },
+    'session_count' => 123,
+    'unsubscribed_from_emails' => true,
+    'last_request_at' => 1_401_970_113,
+    'created_at' => 1_401_970_114,
+    'remote_created_at' => 1_393_613_864,
+    'updated_at' => 1_401_970_114,
+    'user_agent_data' => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_3) AppleWebKit/535.11 (KHTML, like Gecko) Chrome/17.0.963.56 Safari/535.11',
+    'social_profiles' => { 'type' => 'social_profile.list',
+                           'social_profiles' => [
+                             { 'type' => 'social_profile', 'name' => 'twitter', 'url' => 'http://twitter.com/abc', 'username' => 'abc', 'id' => nil },
+                             { 'type' => 'social_profile', 'name' => 'twitter', 'username' => 'abc2', 'url' => 'http://twitter.com/abc2', 'id' => nil },
+                             { 'type' => 'social_profile', 'name' => 'facebook', 'url' => 'http://facebook.com/abc', 'username' => 'abc', 'id' => '1234242' },
+                             { 'type' => 'social_profile', 'name' => 'quora', 'url' => 'http://facebook.com/abc', 'username' => 'abc', 'id' => '1234242' }
+                           ] },
+    'location_data' =>
+          { 'type' => 'location_data',
+            'city_name' => 'Dublin',
+            'continent_code' => 'EU',
+            'country_name' => 'Ireland',
+            'latitude' => '90',
+            'longitude' => '10',
+            'postal_code' => 'IE',
+            'region_name' => 'Europe',
+            'timezone' => '+1000',
+            'country_code' => 'IRL' }
+  }
+end
+
+def test_collection
+  {
+    'id' => '1',
+    'workspace_id' => 'tx2p130c',
+    'name' => 'Collection 1',
+    'url' => 'http://www.intercom.test/help/',
+    'order' => 1,
+    'type' => 'collection',
+    'description' => 'Collection desc',
+    'icon' => 'book-bookmark'
+  }
+end
+
+def test_collection_list
+  {
+    'type' => 'list',
+    'total_count' => 1,
+    'pages' => {
+      'page' => 1,
+      'per_page' => 20,
+      'total_pages' => 1
+    },
+    'data' => [{
+      'id' => '1',
+      'workspace_id' => 'tx2p130c',
+      'name' => 'Collection 1',
+      'url' => 'http://www.intercom.test/help/',
+      'order' => 1,
+      'type' => 'collection',
+      'description' => 'Collection desc',
+      'icon' => 'book-bookmark'
+    }]
+  }
+end
+
+def test_visitor
+  {
+    'type' => 'visitor',
+    'id' => '123',
+    'user_id' => '12334',
+    'anonymous' => true,
+    'email' => nil,
+    'phone' => nil,
+    'name' => nil,
+    'pseudonym' => nil,
+    'app_id' => 'abcd1234',
+    'companies' => { 'type' => 'company.list', 'companies' => [] },
+    'location_data' => {},
+    'last_request_at' => nil,
+    'created_at' => 1_401_970_114,
+    'remote_created_at' => 1_401_970_114,
+    'signed_up_at' => 1_401_970_114,
+    'updated_at' => 1_401_970_114,
+    'session_count' => 0,
+    'social_profiles' => { 'type' => 'social_profile.list', 'social_profiles' => [] },
+    'owner_id' => nil,
+    'unsubscribed_from_emails' => false,
+    'marked_email_as_spam' => false,
+    'has_hard_bounced' => false,
+    'tags' => { 'type' => 'tag.list', 'tags' => [] },
+    'segments' => { 'type' => 'segment.list', 'segments' => [] },
+    'custom_attributes' => {},
+    'referrer' => nil,
+    'utm_campaign' => nil,
+    'utm_content' => nil,
+    'utm_medium' => nil,
+    'utm_source' => nil,
+    'utm_term' => nil,
+    'do_not_track' => nil
   }
 end
 
 def test_admin_list
   {
-    "type" => "admin.list",
-    "admins" => [
+    'type' => 'admin.list',
+    'admins' => [
       {
-        "type" => "admin",
-        "id" => "1234",
-        "name" => "Hoban Washburne",
-        "email" => "wash@serenity.io"
+        'type' => 'admin',
+        'id' => '1234',
+        'name' => 'Hoban Washburne',
+        'email' => 'wash@serenity.io'
       }
     ]
   }
@@ -128,34 +245,88 @@ end
 
 def test_admin
   {
-    "type" => "admin",
-    "id" => "1234",
-    "name" => "Hoban Washburne",
-    "email" => "wash@serenity.io"
+    'type' => 'admin',
+    'id' => '1234',
+    'name' => 'Hoban Washburne',
+    'email' => 'wash@serenity.io'
+  }
+end
+
+def test_team_list
+  {
+    'type' => 'team.list',
+    'teams' => [
+      {
+        'type' => 'team',
+        'id' => '2744328',
+        'name' => 'the_a_team',
+        'admin_ids' => [646_303, 814_860]
+      },
+      {
+        'type' => 'team',
+        'id' => '814865',
+        'name' => 'BA_App',
+        'admin_ids' => [492_881, 1_195_856]
+      }
+    ]
+  }
+end
+
+def test_team
+  {
+    'type' => 'team',
+    'id' => '2744328',
+    'name' => 'the_a_team',
+    'admin_ids' => [646_303, 814_860]
+  }
+end
+
+def test_company(name = 'Blue Sun')
+  {
+    'type' => 'company',
+    'id' => '531ee472cce572a6ec000006',
+    'name' => name,
+    'plan' => {
+      'type' => 'plan',
+      'id' => '1',
+      'name' => 'Paid'
+    },
+    'company_id' => '6',
+    'remote_created_at' => 1_394_531_169,
+    'created_at' => 1_394_533_506,
+    'updated_at' => 1_396_874_658,
+    'last_request_at' => 1_396_874_658,
+    'monthly_spend' => 49,
+    'session_count' => 26,
+    'user_count' => 10,
+    'custom_attributes' => {
+      'paid_subscriber' => true,
+      'team_mates' => 0
+    }
   }
 end
 
-def test_company
+def test_company_dates(name = 'Blue Sun', created_at = 1_401_970_114, last_request_at = 1_401_970_113)
   {
-    "type" => "company",
-    "id" => "531ee472cce572a6ec000006",
-    "name" => "Blue Sun",
-    "plan" => {
-      "type" =>"plan",
-      "id" =>"1",
-      "name" =>"Paid"
+    'type' => 'company',
+    'id' => '531ee472cce572a6ec000006',
+    'name' => name,
+    'plan' => {
+      'type' => 'plan',
+      'id' => '1',
+      'name' => 'Paid'
     },
-    "company_id" => "6",
-    "remote_created_at" => 1394531169,
-    "created_at" => 1394533506,
-    "updated_at" => 1396874658,
-    "last_request_at" => 1396874658,
-    "monthly_spend" => 49,
-    "session_count" => 26,
-    "user_count" => 10,
-    "custom_attributes" => {
-      "paid_subscriber"  => true,
-      "team_mates" => 0
+    'company_id' => '6',
+    'remote_created_at' => 1_394_531_169,
+    'created_at' => created_at,
+    'updated_at' => 1_396_874_658,
+    'last_request_at' => last_request_at,
+    'monthly_spend' => 49,
+    'session_count' => 26,
+    'user_count' => 10,
+    'custom_attributes' => {
+      'paid_subscriber' => true,
+      'team_mates' => 0
     }
   }
 end
@@ -166,163 +337,327 @@ end
 
 def test_message
   {
-      "created_at" => 1329837506,
-      "updated_at" => 1329664706,
-      "read" => true,
-      "created_by_user" => true,
-      "thread_id" => 5591,
-      "messages" => [
-          {
-              "created_at" => 1329837506,
-              "html" => "<p>Hey Intercom, What is up?</p>\n",
-              "from" => {
-                  "email" => "bob@example.com",
-                  "name" => "Bob",
-                  "user_id" => "123",
-                  "is_admin" => false
-              }
-          },
-          {
-              "created_at" => 1329664706,
-              "rendered_body" => "<p>Not much, you?</p>\n",
-              "from" => {
-                  "name" => "Super Duper Admin",
-                  "avatar" => {
-                    "square_25" => "https://static.intercomcdn.com/avatars/13347/square_25/Ruairi_Profile.png?1375368166",
-                    "square_50" => "https://static.intercomcdn.com/avatars/13347/square_50/Ruairi_Profile.png?1375368166",
-                    "square_128" => "https://static.intercomcdn.com/avatars/13347/square_128/Ruairi_Profile.png?1375368166"
-                  },
-                  "is_admin" => true
-              }
+    'created_at' => 1_329_837_506,
+    'updated_at' => 1_329_664_706,
+    'read' => true,
+    'created_by_user' => true,
+    'thread_id' => 5591,
+    'messages' => [
+      {
+        'created_at' => 1_329_837_506,
+        'html' => "<p>Hey Intercom, What is up?</p>\n",
+        'from' => {
+          'email' => 'bob@example.com',
+          'name' => 'Bob',
+          'user_id' => '123',
+          'is_admin' => false
+        }
+      },
+      {
+        'created_at' => 1_329_664_706,
+        'rendered_body' => "<p>Not much, you?</p>\n",
+        'from' => {
+          'name' => 'Super Duper Admin',
+          'avatar' => {
+            'square_25' => 'https://static.intercomcdn.com/avatars/13347/square_25/Ruairi_Profile.png?1375368166',
+            'square_50' => 'https://static.intercomcdn.com/avatars/13347/square_50/Ruairi_Profile.png?1375368166',
+            'square_128' => 'https://static.intercomcdn.com/avatars/13347/square_128/Ruairi_Profile.png?1375368166'
           },
-          {
-              "created_at" => 1329664806,
-              "rendered_body" => "<p>Not much either :(</p>\n",
-              "from" => {
-                  "email" => "bob@example.com",
-                  "name" => "Bob",
-                  "user_id" => "123",
-                  "is_admin" => false
-              }
-          }
-      ]
+          'is_admin' => true
+        }
+      },
+      {
+        'created_at' => 1_329_664_806,
+        'rendered_body' => "<p>Not much either :(</p>\n",
+        'from' => {
+          'email' => 'bob@example.com',
+          'name' => 'Bob',
+          'user_id' => '123',
+          'is_admin' => false
+        }
+      }
+    ]
   }
 end
 
-def page_of_users(include_next_link= false)
+def page_of_users(include_next_link = false)
   {
-     "type"=>"user.list",
-     "pages"=>
+    'type' => 'user.list',
+    'pages' =>
       {
-        "type"=>"pages",
-        "next"=> (include_next_link ? "https://api.intercom.io/users?per_page=50&page=2" : nil),
-        "page"=>1,
-        "per_page"=>50,
-        "total_pages"=>7
+        'type' => 'pages',
+        'next' => (include_next_link ? 'https://api.intercom.io/users?per_page=50&page=2' : nil),
+        'page' => 1,
+        'per_page' => 50,
+        'total_pages' => 7
       },
-      "users"=> [test_user("user1@example.com"), test_user("user2@example.com"), test_user("user3@example.com")],
-      "total_count"=>314
+    'users' => [test_user('user1@example.com'), test_user('user2@example.com'), test_user('user3@example.com')],
+    'total_count' => 314
+  }
+end
+
+def page_of_contacts(include_starting_after = false)
+  {   'type' => 'list',
+      'data' => [
+        {
+          'type' => 'contact',
+          'id' => '123',
+          'workspace_id' => 'abc',
+          'external_id' => '12345',
+          'role' => 'lead',
+          'email' => 'test1@example.com',
+          'name' => 'Test',
+          'unsubscribed_from_emails' => false,
+          'created_at' => 1_573_035_771,
+          'updated_at' => 1_573_035_771,
+          'custom_attributes' => {},
+          'tags' => {
+            'type' => 'list',
+            'data' => [],
+            'url' => '/contacts/12345/tags'
+          },
+          'notes' => {
+            'type' => 'list',
+            'data' => [],
+            'url' => '/contacts/12345/notes'
+          },
+          'companies' => {
+            'type' => 'list',
+            'data' => [],
+            'url' => '/contacts/12345/companies'
+          }
+        },
+        {
+          'type' => 'contact',
+          'id' => '321',
+          'workspace_id' => 'abc',
+          'external_id' => '54321',
+          'role' => 'user',
+          'email' => 'test2@example.com',
+          'name' => 'Test',
+          'unsubscribed_from_emails' => false,
+          'created_at' => 1_573_035_771,
+          'updated_at' => 1_573_035_771,
+          'custom_attributes' => {},
+          'tags' => {
+            'type' => 'list',
+            'data' => [],
+            'url' => '/contacts/54321/tags'
+          },
+          'notes' => {
+            'type' => 'list',
+            'data' => [],
+            'url' => '/contacts/54321/notes'
+          },
+          'companies' => {
+            'type' => 'list',
+            'data' => [],
+            'url' => '/contacts/54321/companies'
+          }
+        },
+        {
+          'type' => 'contact',
+          'id' => '111',
+          'workspace_id' => 'abc',
+          'external_id' => '111',
+          'role' => 'lead',
+          'email' => 'test3@example.com',
+          'name' => 'Test',
+          'unsubscribed_from_emails' => false,
+          'created_at' => 1_573_035_771,
+          'updated_at' => 1_573_035_771,
+          'custom_attributes' => {},
+          'tags' => {
+            'type' => 'list',
+            'data' => [],
+            'url' => '/contacts/111/tags'
+          },
+          'notes' => {
+            'type' => 'list',
+            'data' => [],
+            'url' => '/contacts/111/notes'
+          },
+          'companies' => {
+            'type' => 'list',
+            'data' => [],
+            'url' => '/contacts/111/companies'
+          }
+        }
+      ],
+      'total_count' => 3,
+      'pages' => {
+        'type' => 'pages',
+        'next' => (include_starting_after ? { 'page' => 2, 'starting_after' => 'EnCrYpTeDsTrInG' } : nil),
+        'page' => 1,
+        'per_page' => 50,
+        'total_pages' => 1
+      } }
+end
+
+def page_of_companies(include_next_link = false)
+  {
+    'type' => 'company.list',
+    'pages' =>
+          {
+            'type' => 'pages',
+            'next' => (include_next_link ? 'https://api.intercom.io/companies?per_page=50&page=2' : nil),
+            'page' => 1,
+            'per_page' => 50,
+            'total_pages' => 7
+          },
+    'companies' => [test_company('company1'), test_company('company2'), test_company('company3')],
+    'total_count' => 314
   }
 end
 
-def users_scroll(include_users= false)
+def companies_scroll(include_companies = false)
   {
-      "type"=>"user.list",
-      "scroll_param"=> ("da6bbbac-25f6-4f07-866b-b911082d7"),
-      "users"=> (include_users ? [test_user("user1@example.com"), test_user("user2@example.com"), test_user("user3@example.com")] : []),
+    'type' => 'company.list',
+    'scroll_param' => 'da6bbbac-25f6-4f07-866b-b911082d7',
+    'companies' => (include_companies ? [test_company('company1'), test_company('company2'), test_company('company3')] : [])
   }
 end
 
-def users_pagination(include_next_link=false, per_page=0, page=0, total_pages=0, total_count=0, user_list=[])
+def companies_pagination(include_next_link:, per_page:, page:, total_pages:, total_count:, company_list:)
   {
-      "type"=>"user.list",
-      "pages"=>
+    'type' => 'company.list',
+    'pages' =>
           {
-              "type"=>"pages",
-              "next"=> (include_next_link ? "https://api.intercom.io/users?per_page=" \
-                                            + per_page.to_s + "&page=" +  (page+1).to_s : nil),
-              "page"=>page,
-              "per_page"=>per_page,
-              "total_pages"=>total_pages
+            'type' => 'pages',
+            'next' => (include_next_link ? 'https://api.intercom.io/companies?per_page=' \
+                                            + per_page.to_s + '&page=' + (page + 1).to_s : nil),
+            'page' => page,
+            'per_page' => per_page,
+            'total_pages' => total_pages
           },
-      "users"=> user_list,
-      "total_count"=>total_count
+    'companies' => company_list,
+    'total_count' => total_count
   }
 end
 
 def test_conversation
   {
-    "type" => "conversation",
-    "id" => "147",
-    "created_at" => 1400850973,
-    "updated_at" => 1400857494,
-    "conversation_message" => {
-      "type" => "conversation_message",
-      "subject" => "",
-      "body" => "<p>Hi Alice,</p>\n\n<p>We noticed you using our Product, do you have any questions?</p> \n<p>- Jane</p>",
-      "author" => {
-        "type" => "admin",
-        "id" => "25"
+    'type' => 'conversation',
+    'id' => '147',
+    'created_at' => 1_400_850_973,
+    'updated_at' => 1_400_857_494,
+    'conversation_message' => {
+      'type' => 'conversation_message',
+      'subject' => '',
+      'body' => "<p>Hi Alice,</p>\n\n<p>We noticed you using our Product, do you have any questions?</p> \n<p>- Jane</p>",
+      'author' => {
+        'type' => 'admin',
+        'id' => '25'
       },
-      "attachments" => [
+      'attachments' => [
         {
-          "name" => "signature",
-          "url" => "http =>//someurl.com/signature.jpg"
+          'name' => 'signature',
+          'url' => 'http =>//someurl.com/signature.jpg'
         }
       ]
     },
-    "user" => {
-      "type" => "user",
-      "id" => "536e564f316c83104c000020"
+    'user' => {
+      'type' => 'user',
+      'id' => '536e564f316c83104c000020'
     },
-    "assignee" => {
-      "type" => "admin",
-      "id" => "25"
+    'assignee' => {
+      'type' => 'admin',
+      'id' => '25'
     },
-    "open" => true,
-    "read" => true,
-    "conversation_parts" => {
-      "type" => "conversation_part.list",
-      "conversation_parts" => [
+    'open' => true,
+    'read' => true,
+    'conversation_parts' => {
+      'type' => 'conversation_part.list',
+      'conversation_parts' => [
       ]
     }
   }
 end
 
+def test_conversation_list
+  {
+    'type' => 'conversation.list',
+    'pages' => {
+      'type' => 'pages',
+      'page' => 1,
+      'per_page' => 20,
+      'total_pages' => 1
+    },
+    'conversations' => [
+      {
+        'type' => 'conversation',
+        'id' => '147',
+        'created_at' => 1_400_850_973,
+        'updated_at' => 1_400_857_494,
+        'conversation_message' => {
+          'type' => 'conversation_message',
+          'subject' => '',
+          'body' => "<p>Hi Alice,</p>\n\n<p>We noticed you using our Product, do you have any questions?</p> \n<p>- Jane</p>",
+          'author' => {
+            'type' => 'admin',
+            'id' => '25'
+          },
+          'attachments' => [
+            {
+              'name' => 'signature',
+              'url' => 'http =>//someurl.com/signature.jpg'
+            }
+          ]
+        },
+        'user' => {
+          'type' => 'user',
+          'id' => '536e564f316c83104c000020'
+        },
+        'assignee' => {
+          'type' => 'admin',
+          'id' => '25'
+        },
+        'open' => true,
+        'read' => true,
+        'conversation_parts' => {
+          'type' => 'conversation_part.list',
+          'conversation_parts' => [
+          ]
+        }
+      }
+    ]
+  }
+end
+
 def segment
   {
-    "type" => "segment",
-    "id" => "5310d8e7598c9a0b24000002",
-    "name" => "Active",
-    "created_at" => 1393613031,
-    "updated_at" => 1393613031
+    'type' => 'segment',
+    'id' => '5310d8e7598c9a0b24000002',
+    'name' => 'Active',
+    'created_at' => 1_393_613_031,
+    'updated_at' => 1_393_613_031
   }
 end
 
 def segment_list
   {
-    "type" => "segment.list",
-    "segments" => [
+    'type' => 'segment.list',
+    'segments' => [
       {
-        "created_at" => 1393613031,
-        "id" => "5310d8e7598c9a0b24000002",
-        "name" => "Active",
-        "type" => "segment",
-        "updated_at" => 1393613031
+        'created_at' => 1_393_613_031,
+        'id' => '5310d8e7598c9a0b24000002',
+        'name' => 'Active',
+        'type' => 'segment',
+        'updated_at' => 1_393_613_031
       },
       {
-        "created_at" => 1393613030,
-        "id" => "5310d8e6598c9a0b24000001",
-        "name" => "New",
-        "type" => "segment",
-        "updated_at" => 1393613030
+        'created_at' => 1_393_613_030,
+        'id' => '5310d8e6598c9a0b24000001',
+        'name' => 'New',
+        'type' => 'segment',
+        'updated_at' => 1_393_613_030
       },
       {
-        "created_at" => 1393613031,
-        "id" => "5310d8e7598c9a0b24000003",
-        "name" => "Slipping Away",
-        "type" => "segment",
-        "updated_at" => 1393613031
+        'created_at' => 1_393_613_031,
+        'id' => '5310d8e7598c9a0b24000003',
+        'name' => 'Slipping Away',
+        'type' => 'segment',
+        'updated_at' => 1_393_613_031
       }
     ]
   }
@@ -330,207 +665,247 @@ end
 
 def test_tag
   {
-    "id" => "4f73428b5e4dfc000b000112",
-    "name" => "Test Tag",
-    "segment" => false,
-    "tagged_user_count" => 2
+    'id' => '4f73428b5e4dfc000b000112',
+    'name' => 'Test Tag',
+    'segment' => false,
+    'tagged_company_count' => 2
   }
 end
 
 def test_user_notification
   {
-    "type" => "notification_event",
-    "id" => "notif_123456-56465-546546",
-    "topic" => "user.created",
-    "app_id" => "aaaaaa",
-    "data" =>
-    {
-      "type" => "notification_event_data",
-      "item" =>
-      {
-        "type" => "user",
-        "id" => "aaaaaaaaaaaaaaaaaaaaaaaa",
-        "user_id" => nil,
-        "email" => "joe@example.com",
-        "name" => "Joe Schmoe",
-        "avatar" =>
-        {
-          "type" => "avatar",
-          "image_url" => nil
-        },
-        "app_id" => "aaaaa",
-        "companies" =>
-        {
-          "type" => "company.list",
-          "companies" => [ ]
-        },
-        "location_data" =>
-        {
-        },
-        "last_request_at" => nil,
-        "created_at" => "1401970114",
-        "remote_created_at" => nil,
-        "updated_at" => "1401970114",
-        "session_count" => 0,
-        "social_profiles" =>
-        {
-          "type" => "social_profile.list",
-          "social_profiles" => [ ]
-        },
-        "unsubscribed_from_emails" => false,
-        "user_agent_data" => nil,
-        "tags" =>
-        {
-          "type" => "tag.list",
-          "tags" => [ ]
-        },
-        "segments" =>
-        {
-          "type" => "segment.list",
-          "segments" => [ ]
-        },
-        "custom_attributes" =>
-        {
-        }
-      }
-    },
-    "delivery_status" => nil,
-    "delivery_attempts" => 1,
-    "delivered_at" => 0,
-    "first_sent_at" => 1410188629,
-    "created_at" => 1410188628,
-    "links" => { },
-    "self" => nil
+    'type' => 'notification_event',
+    'id' => 'notif_123456-56465-546546',
+    'topic' => 'user.created',
+    'app_id' => 'aaaaaa',
+    'data' =>
+          {
+            'type' => 'notification_event_data',
+            'item' =>
+                  {
+                    'type' => 'user',
+                    'id' => 'aaaaaaaaaaaaaaaaaaaaaaaa',
+                    'user_id' => nil,
+                    'email' => 'joe@example.com',
+                    'name' => 'Joe Schmoe',
+                    'avatar' =>
+                          {
+                            'type' => 'avatar',
+                            'image_url' => nil
+                          },
+                    'app_id' => 'aaaaa',
+                    'companies' =>
+                          {
+                            'type' => 'company.list',
+                            'companies' => []
+                          },
+                    'location_data' =>
+                          {
+                          },
+                    'last_request_at' => nil,
+                    'created_at' => '1401970114',
+                    'remote_created_at' => nil,
+                    'updated_at' => '1401970114',
+                    'session_count' => 0,
+                    'social_profiles' =>
+                          {
+                            'type' => 'social_profile.list',
+                            'social_profiles' => []
+                          },
+                    'unsubscribed_from_emails' => false,
+                    'user_agent_data' => nil,
+                    'tags' =>
+                          {
+                            'type' => 'tag.list',
+                            'tags' => []
+                          },
+                    'segments' =>
+                          {
+                            'type' => 'segment.list',
+                            'segments' => []
+                          },
+                    'custom_attributes' =>
+                          {
+                          }
+                  }
+          },
+    'delivery_status' => nil,
+    'delivery_attempts' => 1,
+    'delivered_at' => 0,
+    'first_sent_at' => 1_410_188_629,
+    'created_at' => 1_410_188_628,
+    'links' => {},
+    'self' => nil
   }
 end
 
 def test_conversation_notification
   {
-     "type"=>"notification_event",
-     "id"=>"notif_123456-56465-546546",
-     "topic"=>"conversation.user.created",
-     "app_id"=>"aaaaa",
-     "data"=>
-     {
-          "type"=>"notification_event_data",
-          "item"=>
+    'type' => 'notification_event',
+    'id' => 'notif_123456-56465-546546',
+    'topic' => 'conversation.user.created',
+    'app_id' => 'aaaaa',
+    'data' =>
           {
-               "type"=>"conversation",
-               "id"=>"123456789",
-               "created_at"=>"1410335293",
-               "updated_at"=>"1410335293",
-               "user"=>
-               {
-                    "type"=>"user",
-                    "id"=>"540f1de7112d3d1d51001637",
-                    "name"=>"Kill Bill",
-                    "email"=>"bill@bill.bill"},
-               "assignee"=>
-               {
-                   "type"=>"nobody_admin",
-                   "id"=>nil
-               },
-               "conversation_message"=>
-               {
-                    "type"=>"conversation_message",
-                    "id"=>"321546",
-                    "subject"=>"",
-                    "body"=>"<p>An important message</p>",
-                    "author"=>
-                    {
-                         "type"=>"user",
-                         "id"=>"aaaaaaaaaaaaaaaaaaaaaa",
-                         "name"=>"Kill Bill",
-                         "email"=>"bill@bill.bill"},
-                    "attachments"=>[]
-               },
-               "conversation_parts"=>
-               {
-                   "type"=>"conversation_part.list",
-                   "conversation_parts"=>[]
-               },
-               "open"=>nil,
-               "read"=>true,
-               "links"=>
-               {
-                   "conversation_web"=>
-                    "https://app.intercom.io/a/apps/aaaaaa/inbox/all/conversations/123456789"}
-          }
-     },
-     "delivery_status"=>nil,
-     "delivery_attempts"=>1,
-     "delivered_at"=>0,
-     "first_sent_at"=>1410335293,
-     "created_at"=>1410335293,
-     "links"=>{},
-     "self"=>nil
+            'type' => 'notification_event_data',
+            'item' =>
+                  {
+                    'type' => 'conversation',
+                    'id' => '123456789',
+                    'created_at' => '1410335293',
+                    'updated_at' => '1410335293',
+                    'user' =>
+                          {
+                            'type' => 'user',
+                            'id' => '540f1de7112d3d1d51001637',
+                            'name' => 'Kill Bill',
+                            'email' => 'bill@bill.bill'
+                          },
+                    'assignee' =>
+                          {
+                            'type' => 'nobody_admin',
+                            'id' => nil
+                          },
+                    'conversation_message' =>
+                          {
+                            'type' => 'conversation_message',
+                            'id' => '321546',
+                            'subject' => '',
+                            'body' => '<p>An important message</p>',
+                            'author' =>
+                                  {
+                                    'type' => 'user',
+                                    'id' => 'aaaaaaaaaaaaaaaaaaaaaa',
+                                    'name' => 'Kill Bill',
+                                    'email' => 'bill@bill.bill'
+                                  },
+                            'attachments' => []
+                          },
+                    'conversation_parts' =>
+                          {
+                            'type' => 'conversation_part.list',
+                            'conversation_parts' => []
+                          },
+                    'open' => nil,
+                    'read' => true,
+                    'links' =>
+                          {
+                            'conversation_web' =>
+                                'https://app.intercom.io/a/apps/aaaaaa/inbox/all/conversations/123456789'
+                          }
+                  }
+          },
+    'delivery_status' => nil,
+    'delivery_attempts' => 1,
+    'delivered_at' => 0,
+    'first_sent_at' => 1_410_335_293,
+    'created_at' => 1_410_335_293,
+    'links' => {},
+    'self' => nil
   }
 end
 
 def test_subscription
-  {"request"=>
-       {"type"=>"notification_subscription",
-        "id"=>"nsub_123456789",
-        "created_at"=>1410368642,
-        "updated_at"=>1410368642,
-        "service_type"=>"web",
-        "app_id"=>"3qmk5gyg",
-        "url"=>
-            "http://example.com",
-        "self"=>
-            "https://api.intercom.io/subscriptions/nsub_123456789",
-        "topics"=>["user.created", "conversation.user.replied", "conversation.admin.replied"],
-        "active"=>true,
-        "metadata"=>{},
-        "hub_secret"=>nil,
-        "mode"=>"point",
-        "links"=>
-            {"sent"=>
-                 "https://api.intercom.io/subscriptions/nsub_123456789/sent",
-             "retry"=>
-                 "https://api.intercom.io/subscriptions/nsub_123456789/retry",
-             "errors"=>
-                 "https://api.intercom.io/subscriptions/nsub_123456789/errors"},
-        "notes"=>[]}}
+  { 'request' =>
+       { 'type' => 'notification_subscription',
+         'id' => 'nsub_123456789',
+         'created_at' => 1_410_368_642,
+         'updated_at' => 1_410_368_642,
+         'service_type' => 'web',
+         'app_id' => '3qmk5gyg',
+         'url' =>
+            'http://example.com',
+         'self' =>
+            'https://api.intercom.io/subscriptions/nsub_123456789',
+         'topics' => ['user.created', 'conversation.user.replied', 'conversation.admin.replied'],
+         'active' => true,
+         'metadata' => {},
+         'hub_secret' => nil,
+         'mode' => 'point',
+         'links' =>
+            { 'sent' =>
+                 'https://api.intercom.io/subscriptions/nsub_123456789/sent',
+              'retry' =>
+                 'https://api.intercom.io/subscriptions/nsub_123456789/retry',
+              'errors' =>
+                 'https://api.intercom.io/subscriptions/nsub_123456789/errors' },
+         'notes' => [] } }
 end
 
 def test_app_count
   {
-    "type" => "count.hash",
-    "company" => {
-      "count" => 8
+    'type' => 'count.hash',
+    'company' => {
+      'count' => 8
     },
-    "segment" => {
-      "count" => 47
+    'segment' => {
+      'count' => 47
     },
-    "tag" => {
-      "count" => 341
+    'tag' => {
+      'count' => 341
     },
-    "user" => {
-      "count" => 12239
+    'user' => {
+      'count' => 12_239
     }
   }
 end
 
+def test_section
+  {
+    'id' => '18',
+    'workspace_id' => 'tx2p130c',
+    'name' => 'Section 1',
+    'url' => 'http://www.intercom.test/help/',
+    'order' => 0,
+    'created_at' => 1_589_801_953,
+    'updated_at' => 1_589_801_953,
+    'type' => 'section',
+    'parent_id' => 1
+  }
+end
+
+def test_section_list
+  {
+    'type' => 'list',
+    'total_count' => 1,
+    'pages' => {
+      'page' => 1,
+      'per_page' => 20,
+      'total_pages' => 1
+    },
+    'data' => [{
+      'id' => '18',
+      'workspace_id' => 'tx2p130c',
+      'name' => 'Section 1',
+      'url' => 'http://www.intercom.test/help/',
+      'order' => 0,
+      'created_at' => 1_589_801_953,
+      'updated_at' => 1_589_801_953,
+      'type' => 'section',
+      'parent_id' => 1
+    }]
+  }
+end
+
 def test_segment_count
   {
-    "type" => "count",
-    "user" => {
-      "segment" => [
+    'type' => 'count',
+    'user' => {
+      'segment' => [
         {
-          "Active" => 1
+          'Active' => 1
         },
         {
-          "New" => 0
+          'New' => 0
         },
         {
-          "VIP" => 0
+          'VIP' => 0
         },
         {
-          "Slipping Away" => 0
+          'Slipping Away' => 0
         },
         {
-          "segment 1" => 1
+          'segment 1' => 1
         }
       ]
     }
@@ -539,50 +914,120 @@ end
 
 def test_conversation_count
   {
-    "type" => "count",
-    "conversation" => {
-      "assigned" => 1,
-      "closed" => 15,
-      "open" => 1,
-      "unassigned" => 0
+    'type' => 'count',
+    'conversation' => {
+      'assigned' => 1,
+      'closed' => 15,
+      'open' => 1,
+      'unassigned' => 0
     }
   }
 end
 
 def test_event
-    {
-      "type" => "event",
-      "event_name"  => "invited-friend",
-      "created_at" => 1389913941,
-      "user_id"  => "314159",
-      "metadata" => {
-        "type" => "user",
-        "invitee_email" => "pi@example.org",
-        "invite_code" => "ADDAFRIEND"
-      }
+  {
+    'type' => 'event',
+    'event_name' => 'invited-friend',
+    'created_at' => 1_389_913_941,
+    'user_id' => '314159',
+    'metadata' => {
+      'type' => 'user',
+      'invitee_email' => 'pi@example.org',
+      'invite_code' => 'ADDAFRIEND'
     }
+  }
 end
 
 def test_event_list
   {
-    "type" => "event.list",
-    "events" => [ test_event ],
-    "pages" => {
-      "next" => "https =>//api.intercom.io/events?type=user&intercom_user_id=55a3b&before=144474756550"
+    'type' => 'event.list',
+    'events' => [test_event],
+    'pages' => {
+      'next' => 'https://api.intercom.io/events?type=user&intercom_user_id=55a3b&before=144474756550'
     }
   }
 end
 
+def tomorrow
+  (DateTime.now.to_time + 1).to_i
+end
+
+def page_of_events(include_next_link = false)
+  {
+    'type' => 'event.list',
+    'events' => [test_event],
+    'pages' =>
+      {
+        'next' => (include_next_link ? 'https://api.intercom.io/events?type=user&intercom_user_id=55a3b&before=144474756550' : nil)
+      }
+  }
+end
+
+def test_data_attribute
+  {
+    'type' => 'data_attribute',
+    'model' => 'contact',
+    'name' => 'region_name',
+    'full_name' => 'location_data.region_name',
+    'label' => 'Region',
+    'description' => '',
+    'data_type' => 'string',
+    'api_writable' => false,
+    'ui_writable' => true,
+    'custom' => false,
+    'archived' => false
+  }
+end
+
+def test_data_attribute_list
+  {
+    'type' => 'data_attribute.list',
+    'data_attributes' => [
+      {
+        'type' => 'data_attribute',
+        'model' => 'customer',
+        'name' => 'paid_subscriber',
+        'full_name' => 'custom_attributes.paid_subscriber',
+        'label' => 'paid_subscriber',
+        'description' => '',
+        'data_type' => 'string',
+        'options' => %w[
+          pick_value_1
+          pick_value_2
+        ],
+        'api_writable' => true,
+        'ui_writable' => true,
+        'custom' => true,
+        'archived' => false,
+        'admin_id' => '1',
+        'created_at' => 1_392_734_388,
+        'updated_at' => 1_392_734_388
+      },
+      {
+        'type' => 'data_attribute',
+        'model' => 'customer',
+        'name' => 'region_name',
+        'full_name' => 'location_data.region_name',
+        'label' => 'Region',
+        'description' => '',
+        'data_type' => 'string',
+        'api_writable' => false,
+        'ui_writable' => true,
+        'custom' => false,
+        'archived' => false
+      }
+    ]
+  }
+end
+
 def error_on_modify_frozen
   RUBY_VERSION =~ /1.8/ ? TypeError : RuntimeError
 end
 
 def capture_exception(&block)
-  begin
-    block.call
-  rescue => e
-    return e
-  end
+  block.call
+rescue StandardError => e
+  e
 end
 
 def unshuffleable_array(array)