User Guide
API DOCSVOICE GATEWAYHELPSECURITY
Current Version
Current Version
  • Welcome
  • What's New
  • 🚀GETTING STARTED
    • Login
    • Concepts and Glossary
    • Language Models
      • Syntphony NLP
      • Other NLP and LLM Connectors
      • FAQs
    • Build a Virtual Agent
      • Overview
      • From Scratch
      • By Importing
      • Pre-Built Templates
      • Training task
    • Testing
      • Automated Test
      • Advanced Request
      • Simulate Dialog
      • View Logs
    • Create and manage profiles
  • 💬BUILD DIALOGS
    • Flows
    • Dialog Cells
      • Intent
      • Entity
      • Answer
      • Input
      • Jump
      • End
      • Service
      • Rest Connector
      • Code
      • Rule
        • Variable answers using Code and Rule cells
        • Enable and disable flows using Rule Cells
    • Data Masking of Personal Identificable Information
    • Dynamic Content and Contexts
    • Voice Agent
    • Multilingual Agent (beta)
  • ✨GENERATIVE AI
    • AI features
    • Assist Answer (beta)
    • Examples Generator
    • Knowledge AI
    • Prompt cell
      • Prompt crafting
      • Practical examples
    • Rephrase Answer
    • Zero-Shot LLM
  • 🌐CHANNELS
    • Channels
      • WhatsApp (by Infobip)
      • Facebook Messenger
      • Microsoft Teams
      • Integrating Existing Channels
    • Webchat Plugin
  • ⚙️CONFIGURATIONS
    • Parameters
    • Advanced Resources
    • Other Options
      • Intent Navigator
  • 📊ANALYTICS & INSIGHTS
    • Dashboards
      • Overview
      • Funnel charts
      • User messages
      • Conversations
      • Reports
    • External Analytics Platforms
  • API DOCS
    • Overview
    • API Guidelines
      • Conversation API
      • Cloner API
      • EVG Connector
      • Management API
        • Admin API
          • Bot Admin
          • Environment
          • Organization
          • User
          • Notification
        • Instance API
          • Knowledge AI
          • Knowledge AI NLP
          • Answer
          • Automated Tests
          • Bot
          • Broker
          • Channel
          • Dashboard
          • Dialog Manager
          • Entity
          • Generative Service
          • Intent
          • Parameters
          • Tag
          • Technical Log
          • Training
          • Transactional Service
          • Rest Connector
          • Wait Input
          • Websnippet
      • Webhooks
    • Infrastructure Guidelines
      • Syntphony CAI server Installation guide
      • Maintenance Methods
      • Supported/verified third-party software
    • Data Structure
      • Admin Data Structure
      • Environment Data Structure
    • Voice Gateway
      • Genesys Cloud CX
Powered by GitBook
On this page
  • Rest Connectors
  • Authentication
  • Result handling
  • Dynamic Fields

Was this helpful?

  1. BUILD DIALOGS
  2. Dialog Cells

Rest Connector

PreviousServiceNextCode

Last updated 8 months ago

Was this helpful?

Easily connect our resources to your client's by using our Rest Connector cell within Syntphony CAI platform.

Rest Connector Cells use . Hence, we highly recommend you reading the dedicated page to ensure a comprehensive understanding.

Rest Connectors

Each Rest Connector cell has its own unique URL and requires an Authentication step. This allows you to incorporate different APIs and integrations into your existing flow.

This cell requires some development expertise and and familiarity with the APIs you are integrating. If you're not a developer, reach your development team beforehand to clarify the desired outcomes you are aiming for.

Creating a Rest Connector cell

To create a Rest Connector cell, proceed to the "Advanced Options" on the cells library, select the option Service to choose between Webhook (transactional service) or Rest Connector.

After you clicked Rest Connector, you'll see the modal to create the service cell. Name it and insert your URL.

You may then provide any amount of header pairs you need, and you will fill your Request type and then your content-type, which will include items available for the Request Type you chose. As of now, PATCH is unavailable.

It is important you DO NOT fill in Authentication headers just yet. Those will be handled at a proper step, seen below.

The last field you must fill is the Body. This may be empty, and otherwise should meet the expected body type criteria.

Since this cell is intended to access APIs you have access to, we do not validate the correctness of the body. It is expected that you can debug the integration using your own logs.

You can describe it and add up to 5 tags. After that, you can add options.

Authentication

The last and mandatory part to fill in is the Authentication. Just above the URL, you'll see the "Edit the Authentication service" text button. Click it to choose from the available Authentication types. Those will either require you to simply fill a static Basic or Bearer authentication, or allow you to setup an oAuth2 form.

The oAuth2 form allows you to choose between Password and Client Credentials. By selecting this, a separate call will be used immediately before the configured cell's, and it's resulting body will be used as it's Bearers header.

Result handling

This cell contains branching paths. If the request and it's parsing were successful, the flow will continue. For a scenario where the Authorization, request, or handling fails, Syntphony CAI creates a service error option automatically. As service errors are treated like any other service option, you can add answers after it.

Dynamic Fields

  • Url

  • Body

  • Authentication fields

  • Headers

This means that you can use ongoing conversation data such as previous results stored in context variables or user inputs into your API.

The Rest Connector cell executes the Rest Request you configure based on user inputs and retrieves the results into a designated parameter.

Lastly, the remaining field is "Output". This field works exactly as in the . You may parse the result however you want, and on that moment and that alone. The result will always be available as "hiddenContext.RestConnectorResponse". From there, you can choose to extract and handle specific parts, similar to how you would do it in a Code cell.

Much like other cells, some fields in the Rest Connector are compliant with . You may access any environment-defined parameter, bot-defined parameter or user context and you will have its data filled during execution. The fields are:

This tools is particularly useful if you handle user input and format it with the assistance of .

💬
Code cell
Dynamic Content
Dynamic Content
Generative cells
The modal of a Rest Connector
The Authentication options
hiddenContext