# IBM Watson Assistant Detection Action

This action will parse any user text through IBM Watson Assistant AI engine. The conversation will not hold as a direct input. This action will trigger whenever the user text matches the configured intent.

![](https://content.gitbook.com/content/tZEstFBYh3uMutlup6ku/blobs/AiRRojoTe3NcSkeoKmMD/image.png)

### Settings

The action uses the following settings:

| Setting                       | Description                                                                                                              | [Parsed](https://docs.mylinkconnect.com/actions-and-operations/dynamic-parsing) |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
| API Version                   | Choose the IBM Watson API Version to use                                                                                 | :no\_entry:                                                                     |
| Username                      | The IBM Watson integration username                                                                                      | :white\_check\_mark:                                                            |
| Password                      | The IBM Watson integration password                                                                                      | :white\_check\_mark:                                                            |
| Workspace Id or Workspace Url | Set here the full workspace id or the full workspace url of your IBM Watson assistant API integration                    | :white\_check\_mark:                                                            |
| Intent                        | The full name of the intent you want to be parsed. Use asterisk (\*) to accept any intent                                | :white\_check\_mark:                                                            |
| Detection Confidence          | The minimum confidence required to trigger this action                                                                   | :no\_entry:                                                                     |
| Display intent reply in chat  | If enabled, Connect will display a message bubble with the text you've specified as possible intent reply on IBM Watson. | :no\_entry:                                                                     |

### Remarks

When used inside an [interaction](https://docs.mylinkconnect.com/basic-concepts/the-chatbot-designer/interactions_concepts) or [behavior](https://docs.mylinkconnect.com/basic-concepts/the-chatbot-designer/behaviours_concepts), this action **is not blocking.** The conversation is not halted and the user can continue freely. If you want to stop the user until the question requirements have been met, you can use the [IBM Watson Assistant Input](https://docs.mylinkconnect.com/actions-and-operations/input/ibm-watson-assistant/xenioo.bots.actions.ibmwatson.ibmwatsonassistantinputaction).

This action is optimized to use IBM Watson API only once per user input. Even using multiple IBM Watson Detection actions will result in a single API call. Every IBM Watson AP call will count as an [additional chatbot message](https://docs.mylinkconnect.com/basic-concepts/your-account/messages-count#integrations).

Any integration issue that MyLINK Connect encounters during IBM Watson API calls can be found inside each conversation [Execution Diagram](https://docs.mylinkconnect.com/actions-and-operations/execution/execution-diagram) or inside the chatbot preview [Execution Diagram](https://docs.mylinkconnect.com/actions-and-operations/execution/execution-diagram).

If required, instead of the standard Workspace Id, the Legacy v1 Workspace URL can be found the API Details page you can see in the following picture:

![](https://content.gitbook.com/content/tZEstFBYh3uMutlup6ku/blobs/GxnimSGZcpEOJPOZwjWJ/image.png)

###

### Trigger

On Intent Detected. This action will trigger any child operation as soon as the user input is matching the selected intent with at least the specified confidence.

### Variables

This action produces the following variables after being triggered:

| Variable              | Description                             |
| --------------------- | --------------------------------------- |
| wat\_detected\_intent | The intent detected during last input   |
| wat\_reply            | The intent reply received by Dialogflow |

Every [entity](https://docs.mylinkconnect.com/artificial-intelligence/nlp/entities) specified in the detected [expression ](https://docs.mylinkconnect.com/artificial-intelligence/nlp/expressions)will be translated to a runtime variable named after the entity name.

### Availability

Channel specific availability follows the table below:

| Channel          | Availability     |
| ---------------- | ---------------- |
| Facebook         | Fully Available. |
| WhatsApp         | Fully Available. |
| Telegram         | Fully Available. |
| Web              | Fully Available. |
| Alexa            | Fully Available. |
| Google Assistant | Fully Available. |
| Slack            | Fully Available. |
| API              | Fully Available. |

This action can be used only at [Bot Global level](https://docs.mylinkconnect.com/execution#global-and-local-actions) or [Behavior level.](https://docs.mylinkconnect.com/execution#global-and-local-actions)

### Further Reading

{% embed url="<https://www.xenioo.com/en/integrating-ibm-watson-assistant-nlp-with-xenioo/>" %}