From Bright Pattern Documentation
< 5.19:Zapier-integration-guide‎ | Configuration
Revision as of 04:04, 29 May 2024 by BpDeeplTranslateMaintenance (talk | contribs) (Updated via BpDeleteTranslateTags script)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
• 5.19 • 5.3 • 5.8

Create an Integration in Zapier Platform

Step 1: Create a New Integration

  1. In Zapier Platform, navigate to section My Integrations and click Start a Zapier Integration; you will be directed to the Create Integration page.
  2. When entering your integration details, fill out all required fields then click Create.


Fill in all required fields for your new integration


Step 2: Configure Authentication

After creating the integration, you will configure authentication, which requires a test request.

  1. Select Basic Authentication, and then in either Code mode or Form mode, enter the following information:
    • In Code mode
      • URL: 'https://your_tenant.brightpattern.com/clientweb/api/v1/workflow-trigger?tenantUrl=your_tenant.com'
      • Method: 'GET'
    • In Form mode
      • Method: GET
      • URL: https://your_tenant.brightpattern.com/clientweb/api/v1/workflow-trigger
      • Show Options > URL Params
        • Key: tenantUrl
        • Value: your_tenant.brightpattern.com
  2. Note: Only basic authentication is supported. Additionally, you may be required to create a Connection Label for your Zap.

    Configure basic authentication


  3. After entering the test request information, you will test your authentication. Under the Test Setup tab, click Connect an Account. A window will pop up asking for your username and password; enter the username and password from the integration account you entered in the Contact Center Administrator application. When accepted, the account connection will appear as a selectable connection option (i.e., if you enter in different account credentials, more than one connection option will appear).

    Select the appropriate account connection


  4. After selecting the appropriate account connection, click Test Authentication. If your authentication is configured correctly, you should receive a 200 status code in the HTTP response headers, which means the connection is OK; the response body will be empty. Save your authentication and move on to Triggers.

    Verify your test authentication was successful

Step 3: Configure the Trigger

Next, you will create a trigger for your integration.

  1. In the Settings tab, enter all the required information and click Save.

    Enter your trigger's settings


  2. In the API Configuration tab, select Polling as the Trigger Type. Note: For our Zapier integration, only Polling is supported. For the API Endpoint, in either Code mode or Form mode, enter the following:
    • In Code mode
      • URL: 'https://your_tenant.brightpattern.com/clientweb/api/v1/workflow-trigger'
      • Method: 'GET'
      • Headers: 'Accept': 'application/json'
    • In Form mode
      • Method: GET
      • URL: https://your_tenant.brightpattern.com/clientweb/api/v1/workflow-trigger
      • Show Options > HTTP Headers
        • Key: Accept
        • Value: application/json
  3. Click Save API Request & Continue.

    Enter the API configuration


  4. Next, you will test your API request. Select the correct account connection you configured in Authentication or configure and test a new account connection. When finished, click Finish Testing & Continue.

    Test your API request


  5. Finally, you will define your output in JSON format. In the Sample Output field, enter output fields; fields may contain workflow variables and some scenario variables (e.g., $(item.externalChatData)). Note that what is entered here will need to be entered in your workflow’s Zapier Invoke Zap block. When finished, click Generate Output Field Definitions and the fields will populate section Output Fields; you may give these fields labels. When done, click Save Output & Finish.

    Define your output fields
    < Previous | Next >