Merge pull request #48 from mailsac/add_recent_activity

Add recent activity help section
mailsac · Aug 28, 2020 · ce58a11 · ce58a11
2 parents 2d1a967 + 7fc20c8
commit ce58a11
Show file tree

Hide file tree

Showing 6 changed files with 47 additions and 0 deletions.
diff --git a/help/recent_activity/recent_activity.rst b/help/recent_activity/recent_activity.rst
@@ -0,0 +1,28 @@
+.. _Dashboard: https://mailsac.com/dashboard
+.. _pricing: https://mailsac.com/pricing
+.. _`Usage and Analytics`: https://mailsac.com/usage
+
+.. _doc_recent_activity:
+
+Recent Activity
+===============
+
+Recent Activity shows a detailed log of email received,
+:ref:`forwarding <doc_forwarding>`, and :ref:`email sent <doc_sending_mail>`.
+This is useful in troubleshooting problems integrating with Mailsac.
+
+Viewing Recent Activity
+-----------------------
+
+Recent Activity can be viewed from the Dashboard_, then selecting `Usage and
+Analytics`_, then Recent Activity.
+
+.. figure:: recent_activity_log.png
+   :align: center
+   :width: 400px
+
+   This log shows an email sent through the Mailsac outbound server to
+   bclinton@mailsac.com, and a webhook that failed to POST.
+
+The last 15 minutes of activity is available for all users. Extended history
+is available for `Business Plan customers <pricing_>`_.
diff --git a/help/recent_activity/recent_activity_log.png b/help/recent_activity/recent_activity_log.png
diff --git a/index.rst b/index.rst
@@ -59,6 +59,7 @@ Table of Contents
    :name: sec-Help
 
    help/missing_mail
+   help/recent_activity/recent_activity
    help/dns_verification/dns_verification
    help/account_management/account_management
    about/contact_and_support

diff --git a/services/slack_webhook/slack_webhook.rst b/services/slack_webhook/slack_webhook.rst
@@ -105,3 +105,9 @@ Send an email to the :ref:`Private Address <doc_private_addresses>`, that was
    :width: 400px
 
    Slack Webhook notification.
+
+Troubleshooting
+---------------
+
+If Slack is not receiving the webhook, additional debugging information is
+available in :ref:`doc_recent_activity`.
diff --git a/services/webhook/webhook.rst b/services/webhook/webhook.rst
@@ -91,3 +91,9 @@ Webhook contents are very similar to web `socket emails
 
 Read more about JSON Webhooks at the `API Reference
 <https://mailsac.com/docs/api/#webhooks>`_
+
+Troubleshooting
+---------------
+
+If the Webhook forwarding is not working, additional debugging information is
+available in :ref:`doc_recent_activity`.
diff --git a/services/websocket/websocket.rst b/services/websocket/websocket.rst
@@ -255,3 +255,9 @@ Try It
 ^^^^^^
 
 Visit the `Web Socket Test Page <https://sock.mailsac.com>`_ and receive emails in your web browser, without writing any code.
+
+Troubleshooting
+---------------
+
+If the WebSocket is not working, additional debugging information is
+available in :ref:`doc_recent_activity`.