Merge pull request #1840 from sendgrid/develop

5/26/16 Docs Updates

source/API_Reference/Web_API_v3/Mail/index.html

@@ -137,7 +137,7 @@
   {% api_table_param template_id string No "" "The id of a template that you would like to use. If you use a template that contains content and a subject (either text or html), you do not need to specify those in the respective personalizations or message level parameters." 0 %}
   {% api_table_param sections "custom object" No "" "An object of key/value pairs that define large blocks of content that can be inserted into your emails using substitution tags." 0 %}
   {% api_table_param headers "custom object" No "" "An object containing key/value pairs of header names and the value to substitute for them. You must ensure these are properly encoded if they contain unicode characters. Must not be any of the following reserved headers: x-sg-id, x-sg-eid, received, dkim-signature, Content-Type, Content-Transfer-Encoding, To, From, Subject, Reply-To, CC, BCC" 0 %}
-  {% api_table_param categories "array of integers" No "Max 255" "An array of category names for this message. Each category name may not exceed 255 characters. You cannot have more than 10 categories per request." 0 %}
+  {% api_table_param categories "array of strings" No "Max 255" "An array of category names for this message. Each category name may not exceed 255 characters. You cannot have more than 10 categories per request." 0 %}
   {% api_table_param custom_args "custom object" No "" "Values that are specific to the entire send that will be carried along with the email and its activity data. Substitutions will not be made on custom arguments, so any string that is entered into this parameter will be assumed to be the custom argument that you would like to be used. This parameter is overridden by any conflicting <code>personalizations[x].custom_args</code> if that parameter has been defined. If <code>personalizations[x].custom_args</code> has been defined but does not conflict with the values defined within this parameter, the two will be merged. The combined total size of these custom arguments may not exceed 10,000 bytes." 0 %}
   {% api_table_param send_at integer No "" "A unix timestamp allowing you to specify when you want your email to be sent from SendGrid. This is not necessary if you want the email to be sent at the time of your API request." 0 %}
   {% api_table_param batch_id string No "" "This ID represents a batch of emails (AKA multiple sends of the same email) to be associated to each other for scheduling. Including a <code>batch_id</code> in your request allows you to include this email in that batch, and also enables you to cancel or pause the delivery of that entire batch. For more information, please read about <a href="{{root_url}}/API_Reference/Web_API_v3/cancel_schedule_send.html">Cancel Scheduled Sends</a>." 0 %}

source/Classroom/Basics/Billing/is_your_account_billing_frozen.md

@@ -0,0 +1,18 @@
+---
+st:
+  published_at: 2016-05-25
+  type: Classroom
+seo:
+  title: Is your account in a Billing Frozen state?
+  description: Unable to send near the beginning of the month? Your account may be billing frozen...
+  keywords: send, can't, unable, frozen, blocked, locked, unblock, freeze, retry, rerun, charge, payment, missed
+title: Is your account in a Billing Frozen state?
+weight: 0
+layout: page
+navigation:
+  show: true
+---
+
+If you find your account suddenly unable to send mail within the first week of the month, your account could be in a billing frozen state. This occurs when the card on file for your account is declined when we attempted to process payment on the first of the month. 
+
+To reactivate your account please [update your credit card]({{root_url}}/Classroom/Basics/Billing/update_your_credit_card_and_resubmit_payments.html) on file by logging into your SendGrid dashboard and going to [Settings > Plan and Billing Details > Change Billing Info](https://app.sendgrid.com/settings/billing). You can then change or re-enter the card information and then click Save. Once you update the card on file, the payment will process automatically and the account will be unfrozen. 

source/Classroom/Basics/index.html

@@ -91,6 +91,7 @@ <h2><a href="#Misc">Misc.</a></h2>
             <li><a href="{{root_url}}Billing/update_your_credit_card_and_resubmit_payments.html">Update your Credit Card & Resubmit Payments</a></li>
             <li><a href="{{root_url}}Billing/when_do_credits_reset.html">When do credits reset?</a></li>
             <li><a href="{{root_url}}Billing/i_would_like_to_request_a_refund.html">I would like to request a refund</a></li>
+            <li><a href="{{root_url}}Billing/is_your_account_billing_frozen.html">Is Your Account Billing Frozen?</a></li>
             <li><a href="{{root_url}}Billing/where_can_i_find_my_invoices.html">Where can I find my Invoices?</a></li>
         </ul>
     </div>

source/Classroom/Deliver/Delivery_Introduction/the_art_of_notifications.md

@@ -11,7 +11,7 @@ navigation:
   show: true
 ---
 
-Excessive notifications can become the needy partner of email. We try to keep up with them but eventually, we give up and toss them to the wolves. We have seen the frequency of spam complaints from a single recipient increasing. Recipients are having their mailboxes flooded with notifications and must resort to selecting all of their notifications then reporting them as spam. This flood of spam complaints then makes the mailbox provider think that sender is spamming and will begin to throttle their messages. Now the sender is having deliverability problems and the recipient wants to have nothing to do with the sender. There are solutions!
+Excessive notifications can become the needy partner of email. We try to keep up with them but eventually, we give up and toss them to the wolves. We have seen the frequency of spam complaints from a single recipient increasing. Recipients are having their mailboxes flooded with notifications and must resort to selecting all of their notifications then reporting them as spam. This flood of spam complaints then makes the mailbox provider think that sender is spamming and will begin to throttle, filter, or block their messages. Now the sender is having deliverability problems and the recipient wants to have nothing to do with the sender. There are solutions!
 
 ** **
 

source/Classroom/Deliver/Undeliverable_Email/why_did_my_message_show_as_delivered_first_then_as_bounced.md

@@ -0,0 +1,18 @@
+---
+st:
+  published_at: 2016-05-17
+  type: Classroom
+seo:
+  title: Why did my message show as Delivered first and then as Bounced?
+  description: Learn what to do when an email address shows events for both Delivered and Bounced...
+  keywords: delay, delivery, deliver, delivered, after, then, bounce, bounces, bounced
+title: Why did my message show as Delivered first and then as Bounced?
+weight: 0
+layout: page
+navigation:
+  show: true
+---
+
+When looking at your [Activity Feed](https://app.sendgrid.com/email_activity?) or in your own [Event data]({{root_url}}/API_Reference/Webhooks/event.html), you may see a very rare occurrence known as a delayed bounce. A delayed bounce occurs when a message is accepted by a recipient server(Delivered) and then is promptly declined(Bounced). SendGrid ultimately treats these messages as a bounce, and any future sends to this address will be dropped. 
+
+If you wish to continue sending to the address that was affected, you will want to remove them from your bounce suppression list by navigating to [Suppressions > Bounces](https://app.sendgrid.com/suppressions/bounces?) and removing the email from the list or removing via API. You can also remove bounces from this list using the API. If you would like more information as why the email bounced, it is best to contact the mail administrator directly for the intended recipient's mail domain, usually [email protected].

source/Classroom/Send/What_You_Can_Send/welcome_emails_making_a_good_first_impression.md

@@ -11,9 +11,9 @@ navigation:
   show: true
 ---
 
-Much like meeting someone new for the first time, first impressions can make a huge difference in email. Welcome emails allow you to really hit it off with new subscribers. Because your welcome email if the beginning of your relationship with your subscriber, it is considered to be the most crucial message you send. A great welcome email should have a friendly tone, clear branding, set up future email expectations, and encourage users to engage with your product or service. Make sure to include any unsubscribe, website, customer service, and preference center links you may have. 
+Much like meeting someone new for the first time, first impressions can make a huge difference in email. Welcome emails allow you to really hit it off with new subscribers. Because your welcome email is the beginning of your relationship with your subscriber, it is likely one of the most important messages you will send to them. A great welcome email should have a friendly tone, clear branding, set up future email expectations, and encourage users to engage with your product or service. Make sure to include any unsubscribe, website, customer service, and preference center links you may have. 
 
-Welcome emails can also double as a confirmed opt-in message. Confirmed opt-in is a ** ** industry recommended best practice  that helps document permission between sender and recipient, while also eliminating invalid email addresses collected through online forms, in person, or over the phone. By combining your welcome email with your conformation message, you can ensure that your conversation gets off to a great start. 
+If you are using confirmed opt-in, your welcome messages should be sent immediately after your new recipient confirms their email address. If you are not using traditional confirmed opt in, you can use your welcome letter and/or welcome series to determine whether or not you want to continue sending to a particular address. For example: If someone fails to engage with any of the first seven message you send to them, remove them from your active mailing list or send them a winback email.
 
 
 

source/Classroom/Track/Clicks/click_tracking_html_best_practices.md

@@ -11,12 +11,12 @@ navigation:
   show: true
 ---
 
-If you are experiencing issues with the click tracking setting not replacing your original links, please take a look at your link formatting. Links must be in the proper format in order for our click tracking setting to find and replace them. Links must be within an HTML `<a>` tag and be proceeded by **`"http://`** or **`"https://`**  
+If you are experiencing issues with the click tracking setting not replacing your original links, please take a look at your link formatting. Links must be in the proper format in order for our click tracking setting to find and replace them. Links must be within an HTML `<a>` tag, must be quoted, and must be proceeded by **`"http://`** or **`"https://`**  
 Here are some example links that will be properly replaced by our click tracking app:
 
 `<a href="http://www.sendgrid.com">SendGrid</a>`
 
-`<a href="http://sendgrid.com">SendGrid</a>`
+`<a href="https://sendgrid.com">SendGrid</a>`
 
 The following links, even though they may still resolve, will not be captured or replaced by our click tracking system:
 
@@ -32,6 +32,7 @@ The following links, even though they may still resolve, will not be captured or
 _Please note: If you are in the habit of BASE64 encoding your email content we will be unable to detect the encoded `<a>` tags and overwrite them, so clicks will not be tracked in this case._
 {% endinfo %}
 
+Click tracking can be turned off for individual links by including the `clicktracking=off` attribute inside the anchor of an HTML link *before* the `href`. For example, `<a clicktracking=off href="http://example.com">link text</a>` would not be tracked.
 
 
 If you have a Pro 100K package or higher and you have whitelabeled your sending IP address, the replaced click tracking links lie under the whitelabeled subdomain. Pro 100K and higher packages that have not whitelabeled, Essentials packages, and Free packages have click tracking links that resolve through one of SendGrid's domains (sendgrid.net, sendgrid.info, sendgrid.me, etc.).

source/Classroom/Troubleshooting/Account_Administration/ip_access_management_has_locked_me_out_of_my_account.md

@@ -21,7 +21,7 @@ It's possible under some circumstances to accidentally lock yourself out of your
 
 3. Once you have created a ticket, one of our agents will work with you to verify ownership of the account in a number of ways. We reserve the right to be very thorough with this process, as we treat the account security of our customers with very high sensitivity.  
 
-4. Once we can fully verify the ownership of your account to our satisfaction, we can provide access to your IP, or disable the feature entirely. 
+4. Once we can fully verify the ownership of your account to our satisfaction, we can provide access to your IP. After you are able to log back into your account, you can modify your IP access as needed or even disable the feature entirely.
 
 ![]({{root_url}}/images/IPAM_screengrab.png)
 

source/Utilities/event_kit.md

@@ -0,0 +1,30 @@
+---
+st:
+  published_at: 2016-05-17
+  type: Utilities
+seo:
+  title: SendGrid EventKit
+  description: Learn how to better track your data with the open source SendGrid EventKit.
+  keywords: event, store, clicks, opens, download, heroku, eventkit, event, kit, database, post, activity
+title: SendGrid EventKit
+weight: 0
+layout: page
+navigation:
+  show: true
+---
+
+Sendgrid's [Event Notification]({{root_url}}/API_Reference/Webhooks/event.html) feature allows you to recieve POST data for your email events such as Opens, Clicks, Deliveries, and much more. However, traditionally this feature requires that you set up a seperate database on your own to receive and store this posted data. While highly customizable, this method can be development and time intensive. 
+
+Our open source Eventkit app alleviates the hassle of needing to set up an endpoint on your own domain, and provides a simple yet powerful user interface to view and sort your SendGrid event data. Check out the videos below to walk you through the setup and coniguration of EventKit.  
+
+##[Click here](https://github.com/sendgrid/eventkit) to visit the EventKit Github repository.
+
+
+###1. Learn how to install the EventKit app using a free [Heroku](https://www.heroku.com/) instance by watching this step-by-step video:
+
+<iframe src="https://player.vimeo.com/video/167121552" width="700" height="400" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
+
+
+###2. Once you have EventKit set up, watch this video to learn more about the features within as well as how to navigate the user interface. 
+
+##VIDEO COMING SOON