Merge pull request #51 from intercom/dehora/contacts

contacts

Author: dehora

README.md

@@ -79,6 +79,7 @@ libraryDependencies += "io.intercom" % "intercom-java" % "1.0.9"
 Resources this API supports:
 
 - [Users](#users)
+- [Contacts](#contacts)
 - [Companies](#companies)
 - [Admins](#admins)
 - [Events](#events)
@@ -139,6 +140,41 @@ while(users.hasNext()) {
 }
 ```
 
+### Contacts
+
+_Contacts were added in version 1.1 of the client._
+
+```java
+// Create a Contact
+Contact contact = new Contact()
+    .setEmail("fantastic@serenity.io")
+    .addCustomAttribute(newStringAttribute("role", "fence"));
+Contact created = Contact.create(contact);
+
+// Find a single contact by server supplied user id or id
+contact = Contact.findByID("541a144b201ebf2ec5000002");
+contact = Contact.findByUserID("e1a7d875-d83a-46f7-86f4-73be98a98584);
+
+// Update a contact
+contact.setName("Stitch Hessian");
+Contact updated = Contact.update(contact);
+
+// Read a contact list by email
+Contact contacts = Contact.listByEmail("jubal@serenity.io");
+while(contacts.hasNext()) {
+    System.out.println(contacts.next());
+}
+
+// Iterate over all contacts
+Contact allContacts = Contact.list();
+while(allContacts.hasNext()) {
+    System.out.println(allContacts.next());
+}
+
+// Remove a contact
+Contact.delete(contact);
+```
+
 ### Companies
 
 ```java

intercom-java/src/main/java/io/intercom/api/CompanyUpdateBuilder.java

@@ -0,0 +1,33 @@
+package io.intercom.api;
+
+
+import com.google.common.collect.Lists;
+
+import java.util.ArrayList;
+import java.util.List;
+
+class CompanyUpdateBuilder {
+
+    /**
+     * Provide restrictions on the company data that can be sent via a user update
+     */
+    static List<CompanyWithStringPlan> buildUserUpdateCompanies(CompanyCollection c) {
+        final ArrayList<CompanyWithStringPlan> updatableCompanies = Lists.newArrayList();
+        if (c != null) {
+            final List<Company> companies = c.getPage();
+            for (Company company : companies) {
+                final CompanyWithStringPlan updatableCompany = new CompanyWithStringPlan();
+                updatableCompany.setCompanyID(company.getCompanyID());
+                updatableCompany.setName(company.getName());
+                updatableCompany.setSessionCount(company.getSessionCount());
+                updatableCompany.setMonthlySpend(company.getMonthlySpend());
+                updatableCompany.setRemoteCreatedAt(company.getRemoteCreatedAt());
+                if (company.getPlan() != null) {
+                    updatableCompany.setPlan(company.getPlan().getName());
+                }
+                updatableCompanies.add(updatableCompany);
+            }
+        }
+        return updatableCompanies;
+    }
+}