Merge pull request #8319 from braze-inc/mypostcard

Add MyPostcard partner docs

_docs/_partners/home.md

@@ -304,6 +304,8 @@ valid_partner_list:
   url: /docs/partners/data_and_infrastructure_agility/advertising/liveramp/
 - name: Inbox Monster
   url: /docs/partners/data_and_infrastructure_agility/analytics/inbox_monster/
+- name: mypostcard
+  url: /docs/partners/message_orchestration/additional_channels/direct_mail/mypostcard/
 - name: SEEN
   url: /docs/partners/message_personalization/dynamic_content/seen
 - name: Dixa

_docs/_partners/message_orchestration.md

@@ -107,6 +107,8 @@ valid_partner_list:
   url: /docs/partners/message_orchestration/channel_extensions/surveys/typeform/
 - name: Friendbuy
   url: /docs/partners/message_orchestration/channel_extensions/loyalty/friendbuy/
+- name: mypostcard
+  url: /docs/partners/message_orchestration/additional_channels/direct_mail/mypostcard/
 - name: Dixa
   url: /docs/partners/message_orchestration/additional_channels/instant_chat/dixa/
 ---

_docs/_partners/message_orchestration/additional_channels.md

@@ -37,7 +37,9 @@ valid_partner_list:
 - name: Sendbird
   url: /docs/partners/message_orchestration/additional_channels/messaging/sendbird/      
 - name: Regal
-  url: /docs/partners/message_orchestration/additional_channels/messaging/regal/    
+  url: /docs/partners/message_orchestration/additional_channels/messaging/regal/
+- name: MyPostcard
+  url: /docs/partners/message_orchestration/additional_channels/messaging/mypostcard/      
 - name: Dixa
   url: /docs/partners/message_orchestration/additional_channels/instant_chat/dixa/
 ---

_docs/_partners/message_orchestration/additional_channels/direct_mail.md

@@ -18,7 +18,7 @@ valid_partner_list:
   url: /docs/partners/message_orchestration/additional_channels/direct_mail/lob/
 - name: optilyz
   url: /docs/partners/message_orchestration/additional_channels/direct_mail/optilyz/
-
-
+- name: mypostcard
+  url: /docs/partners/message_orchestration/additional_channels/direct_mail/mypostcard/
 
 ---

_docs/_partners/message_orchestration/additional_channels/direct_mail/mypostcard.md

@@ -0,0 +1,109 @@
+---
+nav_title: MyPostcard
+article_title: MyPostcard
+page_order: 1
+description: "This reference article outlines the partnership between Braze and MyPostcard, which allows you to use direct mail as an additional channel for your CRM workflow."
+alias: /partners/mypostcard/
+page_type: partner
+search_tag: Partner
+
+---
+
+# MyPostcard
+
+> [MyPostcard][1], a leading global postcard app, empowers you to execute direct mail campaigns with ease, providing a seamless and profitable way to connect with your customers. 
+
+Use the MyPostcard and Braze integration to effortlessly send your customers print mailings.
+
+## Prerequisites
+
+| Requirement                      | Description                                                                                                             |
+|----------------------------------|-------------------------------------------------------------------------------------------------------------------------|
+| MyPostcard B2B account           | Registering with MyPostcard is required to take advantage of this integration.                                          |
+| B2B API key and credentials        | You can find your API Key and the credentials in the MyPostcard B2B Admin Tool.                                         |
+| Approved MyPostcard B2B campaign | To take advantage of this integration, you need to set up a print mailing campaign in the MyPostcard B2B tool. |
+{: .reset-td-br-1 .reset-td-br-2 .reset-td-br-3  .reset-td-br-4}
+
+## Use cases
+
+To elevate your direct mail campaigns, it’s crucial to move beyond traditional mass mailings and integrate print mailing seamlessly into your workflows. This approach allows you to reach specific customers who have opted out of your email newsletters or whose emails are marked as spam. With MyPostcard, you can effortlessly send print mailing campaigns directly through Braze.
+
+- Build intuitive workflows in Braze, incorporating print mail as a powerful new channel, without any technical expertise.
+- Unlock the potential of personalized print mailings with a few simple steps.
+- Benefit from a straightforward implementation that is backed by personalized support from a dedicated team.
+
+## Integration
+
+To integrate with MyPostcard, [log in or sign up][2] and create your first campaign to use it through [Braze webhooks][3].
+
+### Step 1: Create your Braze webhook template
+
+Create a MyPostcard webhook template to use in future campaigns or Canvases by navigating to **Templates** > **Webhook Templates** in the Braze platform.
+
+{% alert note %}
+If you are using the [older navigation]({{site.baseurl}}/navigation/), go to **Engagement** > **Templates & Media** > **Webhook Templates**.
+{% endalert %}
+
+If you would like to create a one-off MyPostcard webhook campaign or use an existing template, select **Webhook** in Braze when creating a new campaign. Fill out the following fields:
+
+| Field         | Description                                               |
+|---------------|-----------------------------------------------------------|
+| **Webhook URL** | The webhook URL as shown in the B2B Admin Tool.             |
+| **Request Body** | Raw Text (JSON format found in the B2B Admin Tool).        |
+{: .reset-td-br-1 .reset-td-br-2}
+
+#### Request method and headers
+
+MyPostcard requires an HTTP method along with the following HTTP headers to be included in the template.
+
+{% raw %}
+<table>
+  <thead>
+    <tr>
+      <th><strong>Field</strong></th>
+      <th><strong>Details</strong></th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><strong>HTTP Method</strong></td>
+      <td><code>POST</code></td>
+    </tr>
+    <tr>
+      <td><strong>Username</strong></td>
+      <td><code>{{ '&lt;username&gt;' }}</code></td>
+    </tr>
+    <tr>
+      <td><strong>Password</strong></td>
+      <td><code>{{ '&lt;password&gt;' }}</code></td>
+    </tr>
+    <tr>
+      <td><strong>Content-Type</strong></td>
+      <td><code>application/json</code></td>
+    </tr>
+  </tbody>
+</table>
+{% endraw %}
+{: .reset-td-br-1 .reset-td-br-2}
+
+#### Request body
+
+Copy the request body displayed in the B2B Admin Tool, then fill in the placeholders with content using any Liquid personalization tags.
+
+![Compose Tab showing the JSON body and webhook information.][4]
+
+### Step 2: Preview your request
+
+Next, preview your request in the **Preview** panel or go to the **Test** tab, where you can choose a random user, an existing user, or create a custom user to test your webhook. Don’t forget to save your template before leaving the page!
+
+![Test Webhook Tab with different fields to validate the implementation.][5]
+
+{% alert important %}
+Remember to save your template before leaving the page! <br>Updated webhook templates can be found in the **Saved Webhook Templates** list when creating a new [webhook campaign]({{site.baseurl}}/user_guide/message_building_by_channel/webhooks/creating_a_webhook/). 
+{% endalert %}
+
+[1]: https://www.mypostcard.com
+[2]: https://www.mypostcard.com/b2b/admin/
+[3]: https://www.braze.com/docs/user_guide/message_building_by_channel/webhooks
+[4]: {% image_buster /assets/img/mypostcard/mypostcard_compose.jpg %}
+[5]: {% image_buster /assets/img/mypostcard/mypostcard_test.jpg %}