• Documentation >
• Apps >
• Communication >
• Skype

Skype

The Skype modules enable you to monitor events, or send a message and download an attachment in your Skype account.

Getting Started With Skype

Prerequisites

• A Skype account (create an account at skype.com)

• Microsoft Azure Account (create an account at azure.microsoft.com/free)

Note

The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting Skype to Ibexa Connect

To connect your Skype account to Ibexa Connect, you need to create a bot and obtain the Microsoft App ID and password in your Microsoft Azure account.

1. Log in to your Azure Portal.

2. Click Create a resource.

3. In the top center search bar, type bot. From the drop-down list, select Azure Bot.

   

4. Click the Create button.

   

5. In the Azure Bot form, provide the required information about your bot, as follows:

   Bot handle	Enter the name for your bot.
   Subscription	Select the Azure subscription you want to use.
   Resource Group	Create a new resource group, or select an existing one.
   Location	Choose the geographic location for your resource group. It's usually best to choose a location close to you.
   Pricing Tier	Select a pricing tier. You may update the pricing tier at any time. For more information, see Bot Service pricing.
   Type of App	Select Multi Tenant from the drop-down.
   Creation type	Create a new Microsoft App ID.

6. Click Review + create. When Microsoft successfully validates the new bot, click Create.

7. Go to the new resource, and open Channels.

8. Choose Skype and configure the app. Optionally, you can also configure the other settings in the dialog box, e.g., Disable adding of bot to group conversations option in the Groups tab. Close channel settings.

9. Click Add to Skype in the Connected Channels list, and add the bot to your Skype contacts.

   

10. Open Configuration, where you will find the Microsoft App ID.

    

11. Click Manage > + New client secret to create a password.

    

12. Copy the password now.

    Warning

13. Go to Ibexa Connect, and open the Skype module's Create a connection dialog. Click Add.

    

14. Enter the Microsoft App ID (see step 9 above) and Password (see step 11 above) in the respective fields, and click the Continue button to establish the connection.

The connection has been established. You can proceed with setting up the module.

Triggers

Watch Events

Triggers when a specified event occurs.

The webhook URL needs to be generated in Ibexa Connect and then added to resource settings in the Azure portal.

1. Add the Watch events module to your Ibexa Connect scenario. Select events you want to filter received data by.

2. Generate and copy the webhook URL.

   

3. Log in to your Azure portal.

4. Open the desired resource settings, and paste the webhook URL you have copied in step 2 above in the Messaging endpoint field, and click Save.

   

Now, every time the event occurs, the Watch event module in your Ibexa Connect scenario is triggered.

Actions

Download an Attachment

Downloads an attachment file.

URL	Enter (map) the URL you want to download attachment file data from.

Send a Message

Sends a message to the specified conversation.

Conversation ID	Enter (map) the ID of the conversation you want to send a message to. You can map the ID from the Watch events module.
Text	Enter the text of the message that is sent from bot to user.
Text Format	Select the format of the message's text using one of these values: markdown, plain, or xml. For details about text format, see Create messages.
Attachments	Add Attachment objects that define additional information to include in the message. For more details about attachments, refer to the Attachment Object documentation.
Actions	Add the action to apply. For more details about actions, refer to the Rich Cards documentation.
Service URL	Enter the URL that specifies the channel's service endpoint. Set by the channel.