Updates README with more documentation

Fixes a more simple handling for tokens array

Author: [email protected]

README.md

@@ -17,12 +17,42 @@ BarnebysMautic\Auth::initializeOAuth2
 
 ### Fetch a contact id by email
 ```
-$data = BarnebysMautic\Api::getContactIdByMail('[email protected]');
+try {
+    $data = BarnebysMautic\Api::getContactIdByMail('[email protected]');
+} catch (BarnebysMautic\Exception\ContactNotFoundException $exception) {
+    // Handle error
+}
+```
+
+### Sending emails
+
+When sending emails you can with ease use `sendToContact` and just set the email and a templateId.
+If you need to pass on some custom fields to be used in Mautic those can set as a key => value array for parameter 3.
+When sending values contain HTML and to disable Mautic HTML escaper set the 4th parameter to true.
+  
+##### Sending a email with custom fields 
+
+```
+$tokens = [
+    'custom_content' => 'This will value will be available in mautic as {custom_content}'
+];
+
+sendToContact($mail, $templateId, $tokens)
+```
+
+##### Sending a email with html content 
+
+```
+$tokens = [
+    'html_content' => '<span>This html content will not be escpaed</span>'
+];
+
+sendToContact($mail, $templateId, $tokens, true)
 ```
 
 ### Other available methods
 ```
 getContactIdByMail($mail)
-sendToLead($mail, $templateId)
-sendToContact($mail, $templateId)
+sendToLead($mail, $templateId, array $tokens = [], $html = false)
+sendToContact($mail, $templateId, array $tokens = [], $html = false)
 ```

src/Api.php

@@ -84,6 +84,10 @@ public static function sendToLead($email, $templateId, array $tokens = [], $html
      */
     public static function sendToContact($email, $templateId, array $tokens = [], $html = false)
     {
+        if (!isset($tokens['tokens'])) {
+            $tokens = ['tokens' => $tokens];
+        }
+
         $contactId = self::getContactIdByMail($email);
 
         $api = self::getApiInstance();