From 3bb6e97d0da1ebcdaf2a89ccdee0b71c5d242299 Mon Sep 17 00:00:00 2001
From: Tom Mairs <tom@kumomta.com>
Date: Tue, 17 Oct 2023 19:21:32 +0000
Subject: [PATCH] Add Integrations section and Ongage Instructions

---
 docs/userguide/integrations/index.md  |  7 ++++
 docs/userguide/integrations/ongage.md | 59 +++++++++++++++++++++++++++
 2 files changed, 66 insertions(+)
 create mode 100644 docs/userguide/integrations/index.md
 create mode 100644 docs/userguide/integrations/ongage.md

diff --git a/docs/userguide/integrations/index.md b/docs/userguide/integrations/index.md
new file mode 100644
index 00000000..28ca4640
--- /dev/null
+++ b/docs/userguide/integrations/index.md
@@ -0,0 +1,7 @@
+# Integrations
+
+This chapter is focused on partner and adjacent systems integrations.
+Some of the third-party integrations could involve a separate external fee, while others are entirely FOSS (Free and Open Source Software). 
+
+We are available to provide paid professional services to assist you with any of these integrtions.
+
diff --git a/docs/userguide/integrations/ongage.md b/docs/userguide/integrations/ongage.md
new file mode 100644
index 00000000..e6d4a1ff
--- /dev/null
+++ b/docs/userguide/integrations/ongage.md
@@ -0,0 +1,59 @@
+# Ongage SMTP integration  
+
+## Introduction
+
+Ongage is an email marketing platform that allows you create and manage content and campaigns then delvier them through your favourite sending engine. This integration describes how to use KumoMTA as teh delivery engine for Ongage.
+
+## Instructions
+
+### Get KumoMTA 
+
+1. Install KumoMTA as per the installation instructions here  
+https://docs.kumomta.com/userguide/installation/overview/ 
+
+Before finishing this step, you should ensure that you have correctly set up DNS with a resolving sending domain, MX, PTR, SPF, DKIM, etc.   
+
+As part of this process, you will be creating a DNS entry for “bounce.<yoursendingdomain>”, as well as similar tracking and image domains so be prepared to edit your DNS. 
+
+2. Ensure that you can inject mail using SMTP_Auth (Plain) with TLS. Remember to add the access credentials and test it.   https://docs.kumomta.com/userguide/operation/smtpinjection/?h=smtp_auth 
+
+    NOTE: TLS is crucial to this process, so ensure you have a valid and tested certificate attached to your listener config. https://docs.kumomta.com/reference/kumo/start_esmtp_listener/#tls_certificate  
+
+### Get Ongage 
+
+3. Go to Ongage.com and create an account https://www.ongage.com/registration 
+
+4. Create a support ticket to request access to use the “Private SMTP” connector and let them know you are using KumoMTA as the sending MTA. 
+
+Here is some essential reading before you set up the Private SMTP connector: 
+https://ongage.atlassian.net/wiki/spaces/HELP/pages/657817611/The+Ongage+Private+SMTP+Connector  
+
+5. Once registered, you can add a vendor by selecting Vendors > My Connections in the left menu 
+![Select a vendor](../../assets/images/ongage_vendor_select.png)
+ 
+
+6. Create a new connection and add “Private SMTP” as the connection type.  
+**NOTE**: If you do not see this as an option, jump back up to step 4 and ask Ongage Support to add it for you. 
+
+7. Fill in all the required fields and test. 
+
+ - you can choose any username and password you like, KumoMTA has no preset or preference.  These credentials should match what you set in step 2. 
+
+ - Select PLAIN authentication Type 
+
+ - Select YES for “Use TLS” 
+
+ - The SMTP Port should match what your listener is listening on.  Remember to update your public firewall too.  
+
+If you have done everything right, you will see a positive notification that credentials were verified. 
+
+8. Pat yourself on the back then start using Ongage with KumoMTA 
+
+ 
+
+
+ 
+
+ 
+
+