Skip to content

Commit

Permalink
[PR-23094] Create integration partners pages at docs.talkable.com for…
Browse files Browse the repository at this point in the history
… rest of integrations (#344)
  • Loading branch information
Buritos16 authored Nov 27, 2024
1 parent dc62c2f commit f8e6864
Show file tree
Hide file tree
Showing 31 changed files with 457 additions and 3 deletions.
2 changes: 2 additions & 0 deletions source/advanced_features.rst
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,7 @@ each with links to integration details.
advanced_features/params_encryption
advanced_features/events
advanced_features/file_encryption
advanced_features/facebook_login_share
advanced_features/report_password_protection
advanced_features/product_items
advanced_features/passing_custom_data
Expand All @@ -116,6 +117,7 @@ each with links to integration details.
advanced_features/segments
advanced_features/subscribing_to_events
advanced_features/reg_ex
advanced_features/rybbon
advanced_features/url_parameters
advanced_features/utm_tags
advanced_features/white_labeling
Expand Down
85 changes: 85 additions & 0 deletions source/advanced_features/facebook_login_share.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
.. _advanced_features/facebook_login_share:
.. include:: /partials/common.rst

.. meta::
:description: Integrate Facebook Login & Share with your Talkable system for enhanced user authentication and social sharing. Follow our step-by-step guide to enable the app, configure Facebook App IDs, and streamline users login and sharing processes.

Facebook Login & Share
======================

Overview
--------

This documentation provides a comprehensive guide on connecting your Facebook App for Login & Share in Talkable.

.. note::
In case you don't have the Talkable Facebook app installed, users can still log in and share via Facebook, but Talkable's default Facebook app will be used.

Prerequisites
-------------

Before you begin, ensure you have the following:

- Access to the Facebook Developer Console.
- A Facebook App ID.

Integration Steps
-----------------

1. **Install Facebook App from Talkable Apps Store**

- Navigate to the Talkable Apps Store.
- Install the Facebook app.
- Enter your custom Facebook App ID in the provided field. If left blank, Talkable's default Facebook App ID will be used.
- You can find your App ID in the Facebook Developer Console.
- Ensure the Valid OAuth Redirect URIs of your App ID include Talkable’s domain (`www.talkable.com`) and your custom web domain if set up.
- Example App ID format: `1234567890`
- Save the changes.

2. **Activate the Facebook Login & Share App**

- Toggle the activation switch to enable the Facebook Login & Share app.
- The app is now active, allowing users to log in and share content via Facebook using your Facebook App instead of the default Talkable Facebook App.

Creating a Facebook App ID
--------------------------

1. **Access Facebook Developer Console**

- Go to the `Facebook Developer Console <https://developers.facebook.com/>`_.
- Create a new project or select an existing project.

2. **Configure OAuth Consent Screen**

- Navigate to the App settings.
- Fill in the necessary details and save the configuration.

3. **Create App ID**

- Go to the App Dashboard.
- Click on "Create App" and select the appropriate permissions for your app.
- Add Valid OAuth Redirect URIs, including:
- `https://www.talkable.com`
- Your custom domain, if applicable.
- Save and copy the generated App ID.

Error Handling
--------------

Common errors and how to handle them:

- **Invalid App ID**: Ensure the App ID is correctly entered and is active in the Facebook Developer Console.
- **Authorization Errors**: Verify that the Valid OAuth Redirect URIs include the necessary domains.
- **Network Issues**: Retry the request or check your network connection.

Additional Resources
--------------------

- Facebook Developer Console: https://developers.facebook.com/
- Facebook Login Documentation: https://developers.facebook.com/docs/facebook-login

.. note:: For detailed examples and advanced usage, refer to the official Facebook documentation.

**Contact us**

Interested in setting this up? Contact your CSM or get in touch `here <https://lp.talkable.com/lets-talk-referral>`_.
53 changes: 53 additions & 0 deletions source/advanced_features/rybbon.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
.. _advanced_features/rybbon:
.. include:: /partials/common.rst

.. meta::
:description: Integrate Rybbon with your Talkable system to generate gift claim links and manage campaign-specific rewards.

Rybbon
======

Overview
--------

This documentation provides a guide on integrating the Rybbon campaign with your Talkable system. By enabling this feature, you can generate gift claim links for users and customize reward amounts based on campaign settings.

.. note::
Rybbon app must be installed and enabled for this integration to work.

Functionality
-------------

The Rybbon integration allows you to make a claim request within the scope of a specific campaign key and returns a gift claim link.

Example Usage
-------------

1. **Generating a Gift Claim Link**

Takes a campaign key of a Rybbon Talkable campaign to generate a claim link.

.. code-block:: liquid
{{ "a9a3472f4ea858758e0cd686de8408e2" | rybbon }}
This returns a link similar to:
`https://www.rybbon.net/redeem.php?claimcode=ee645de47765bdbede751c8c6f08a619`

2. **Custom Reward Amount for Rybbon Campaigns**

Allows setting a custom reward amount for Rybbon campaigns with variable denomination. The minimum amount conforms to specific Rybbon gift card restrictions, and the maximum is 50.

.. code-block:: liquid
{{ "a9a3472f4ea858758e0cd686de8408e2" | rybbon: amount: 13.5 }}
Limitations
-----------

- Minimum and maximum reward amounts vary based on the specific Rybbon gift card settings.
- Custom reward amounts must not exceed the maximum value of 50.

**Contact us**

Interested in setting this up? Contact your CSM or get in touch `here <https://lp.talkable.com/lets-talk-referral>`_.
4 changes: 4 additions & 0 deletions source/campaigns/editor/filters.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1089,6 +1089,8 @@ Accepts custom amount of reward for Rybbon campaigns with variable denomination.
{{ "a9a3472f4ea858758e0cd686de8408e2" | rybbon: amount: 13.5 }}
Find more details about the integration here: :ref:`Rybbon <advanced_features/rybbon>`

|hr|

.. _tremendous_filter:
Expand All @@ -1106,3 +1108,5 @@ Implies that there is only one funding source in the Tremendous account.
{{ "DEM8ULSSATK0" | tremendous }}
Returns ``https://www.tremendous.com/rewards/payout/reward123``

Find more details about the integration here: :ref:`Tremendous <advanced_features/tremendous>`
4 changes: 4 additions & 0 deletions source/custom_integration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,10 @@ Contents:

.. toctree::

custom_integration/crowdtwist
custom_integration/chatgpt
custom_integration/validity
custom_integration/trustpilot
custom_integration/recharge
custom_integration/salesforce
custom_integration/microsoft
Expand Down
14 changes: 14 additions & 0 deletions source/custom_integration/chatgpt.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
.. _custom_integration/chatgpt:
.. include:: /partials/common.rst

.. meta::
:description: Integrate ChatGPT with your Talkable system to generate AI-driven text for various use cases like AD notes.

ChatGPT
=======

With this integration, Talkable utilizes OpenAI's ChatGPT API to generate custom AI-driven text for Advocate's sharing message or other campaign-specific purposes.

**Contact us**

Interested in setting this up? Contact your CSM or get in touch `here <https://lp.talkable.com/lets-talk-referral>`_.
14 changes: 14 additions & 0 deletions source/custom_integration/crowdtwist.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
.. _custom_integration/crowdtwist:
.. include:: /partials/common.rst

.. meta::
:description: Integrate store credit rewards using CrowdTwist API with Talkable.

CrowdTwist
==========

With this integration, Talkable enables store credit rewards through the CrowdTwist platform, allowing for custom incentives and campaign tagging.

**Contact us**

Interested in setting this up? Contact your CSM or get in touch `here <https://lp.talkable.com/lets-talk-referral>`_.
14 changes: 14 additions & 0 deletions source/custom_integration/trustpilot.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
.. _custom_integration/trustpilot:
.. include:: /partials/common.rst

.. meta::
:description: Integrate Trustpilot with your Talkable system to track reviews as events within campaigns.

Trustpilot
==========

With this integration, Talkable tracks reviews as events in campaigns using Trustpilot's webhook functionality, allowing reviews to be recorded and utilized in marketing efforts.

**Contact us**

Interested in setting this up? Contact your CSM or get in touch `here <https://lp.talkable.com/lets-talk-referral>`_.
14 changes: 14 additions & 0 deletions source/custom_integration/validity.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
.. _custom_integration/validity:
.. include:: /partials/common.rst

.. meta::
:description: Integrate Validity with your Talkable system for additional email validation within campaigns.

Validity
========

With this integration, Talkable performs additional validation on email addresses using the Validity service. This helps maintain accurate and clean customer data and adds an extra layer of security to your Campaign.

**Contact us**

Interested in setting this up? Contact your CSM or get in touch `here <https://lp.talkable.com/lets-talk-referral>`_.
15 changes: 15 additions & 0 deletions source/email_marketing_and_automation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,28 @@ Contents:

.. toctree::

email_marketing_and_automation/bluecore
email_marketing_and_automation/braze
email_marketing_and_automation/cordial
email_marketing_and_automation/createsend
email_marketing_and_automation/cheetah
email_marketing_and_automation/klaviyo
email_marketing_and_automation/yotpo
email_marketing_and_automation/ometria
email_marketing_and_automation/oracle_bronto
email_marketing_and_automation/omnisend
email_marketing_and_automation/mailchimp
email_marketing_and_automation/sailthru
email_marketing_and_automation/sendgrid
email_marketing_and_automation/sfmc
email_marketing_and_automation/getresponse
email_marketing_and_automation/targetbay
email_marketing_and_automation/emarsys
email_marketing_and_automation/exponea
email_marketing_and_automation/hubspot
email_marketing_and_automation/iterable
email_marketing_and_automation/listrak
email_marketing_and_automation/attentive
email_marketing_and_automation/apsis
email_marketing_and_automation/what_counts_pro
email_marketing_and_automation/custom_app
14 changes: 14 additions & 0 deletions source/email_marketing_and_automation/apsis.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
.. _email_marketing_and_automation/apsis:
.. include:: /partials/common.rst

.. meta::
:description: Synchronize Talkable collected emails with Apsis integration.

Apsis
=====

With this integration, Talkable synchronizes all people who opt in for Talkable email marketing during sign up. This way, you will keep all your emails in one place in an automated way.

**Contact us**

Interested in setting this up? Contact your CSM or get in touch `here <https://lp.talkable.com/lets-talk-referral>`_.
14 changes: 14 additions & 0 deletions source/email_marketing_and_automation/bluecore.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
.. _email_marketing_and_automation/bluecore:
.. include:: /partials/common.rst

.. meta::
:description: Synchronize email opt-ins collected with Talkable to Bluecore for email marketing and automation.

Bluecore
========

With this integration, Talkable syncs email opt-ins to Bluecore, facilitating efficient customer data management for targeted email marketing campaigns.

**Contact us**

Interested in setting this up? Contact your CSM or get in touch `here <https://lp.talkable.com/lets-talk-referral>`_.
14 changes: 14 additions & 0 deletions source/email_marketing_and_automation/braze.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
.. _email_marketing_and_automation/braze:
.. include:: /partials/common.rst

.. meta::
:description: Synchronize email opt-ins collected with Talkable to Braze for email marketing and automation.

Braze
=====

With this integration, Talkable syncs email opt-ins to Braze, enabling efficient customer data management for targeted email marketing campaigns.

**Contact us**

Interested in setting this up? Contact your CSM or get in touch `here <https://lp.talkable.com/lets-talk-referral>`_.
14 changes: 14 additions & 0 deletions source/email_marketing_and_automation/cheetah.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
.. _email_marketing_and_automation/cheetah:
.. include:: /partials/common.rst

.. meta::
:description: Synchronize emails and customer fields collected with Talkable to Cheetah for email marketing and automation.

Cheetah
=======

With this integration, Talkable syncs email opt-ins and customer fields to Cheetah, facilitating seamless email marketing and customer data management.

**Contact us**

Interested in setting this up? Contact your CSM or get in touch `here <https://lp.talkable.com/lets-talk-referral>`_.
14 changes: 14 additions & 0 deletions source/email_marketing_and_automation/cordial.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
.. _email_marketing_and_automation/cordial:
.. include:: /partials/common.rst

.. meta::
:description: Synchronize Talkable collected emails with Cordial integration.

Cordial
=======

With this integration, Talkable synchronizes all people who opt in for Talkable email marketing during sign up. This way, you will keep all your emails in one place in an automated way.

**Contact us**

Interested in setting this up? Contact your CSM or get in touch `here <https://lp.talkable.com/lets-talk-referral>`_.
14 changes: 14 additions & 0 deletions source/email_marketing_and_automation/createsend.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
.. _email_marketing_and_automation/createsend:
.. include:: /partials/common.rst

.. meta::
:description: Synchronize Talkable collected emails with CreateSend integration.

CreateSend
==========

With this integration, Talkable synchronizes all people who opt in for Talkable email marketing during sign up. This way, you will keep all your emails in one place in an automated way.

**Contact us**

Interested in setting this up? Contact your CSM or get in touch `here <https://lp.talkable.com/lets-talk-referral>`_.
2 changes: 1 addition & 1 deletion source/email_marketing_and_automation/emarsys.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
.. include:: /partials/common.rst

.. meta::
:description: Synchronize emails Talkable collected with Hubspot integration.
:description: Synchronize Talkable collected emails with Hubspot integration.

Emarsys
=======
Expand Down
14 changes: 14 additions & 0 deletions source/email_marketing_and_automation/exponea.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
.. _email_marketing_and_automation/exponea:
.. include:: /partials/common.rst

.. meta::
:description: Synchronize email opt-ins collected with Talkable to Exponea for email marketing and automation.

Exponea
=======

With this integration, Talkable syncs email opt-ins to Exponea, supporting enhanced customer data management for targeted email marketing campaigns.

**Contact us**

Interested in setting this up? Contact your CSM or get in touch `here <https://lp.talkable.com/lets-talk-referral>`_.
Loading

0 comments on commit f8e6864

Please sign in to comment.