The API enables you to start online meetings from your own application, write data/documents to the meeting, and read it back in your application.

This page describes the Idiligo API with GET and POST requests. The placeholders shown need to be replaced by the actual values.


1. Log in and obtain a security token

To log in, you need an Idiligo account with a username, password, and API key. This API key can be obtained in your account setting. This request returns a security token, which remains valid for 24 hours.


HTTP GET
GET /InsideService20.asmx/Login?apikey=string&username=string&password=string HTTP/1.1 
Host: app.idiligo.com
HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<string xmlns="http://www.idiligo.com/">string</string>

HTTP POST
POST /InsideService20.asmx/Login HTTP/1.1 
Host: app.idiligo.com 
Content-Type: application/x-www-form-urlencoded 
Content-Length: length 

apikey=string&username=string&password=string
HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<string xmlns="http://www.idiligo.com/">string</string>


2. Create a participant for your online meeting

Optionally, you can create the participant for your online meeting. You need the security token and the email address of the participant. This request returns the participant ID.


HTTP GET
GET /InsideService20.asmx/CreateContact?token=string&email=string HTTP/1.1 
Host: app.idiligo.com
HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<string xmlns="http://www.idiligo.com/">long</long>

HTTP POST
POST /InsideService20.asmx/CreateContact HTTP/1.1 
Host: app.idiligo.com 
Content-Type: application/x-www-form-urlencoded 
Content-Length: length 

token=string&email=string
HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<string xmlns="http://www.idiligo.com/">long</long>


3. Create an online meeting

To start an online meeting, you need the security token and the code of the script you want to use in the online meeting. This request returns the non-public meeting ID.


HTTP GET
GET /InsideService20.asmx/CreateCall?token=string&trajectCode=string HTTP/1.1 
Host: app.idiligo.com
HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<string xmlns="http://www.idiligo.com/">long</long>

HTTP POST
POST /InsideService20.asmx/CreateCall HTTP/1.1 
Host: app.idiligo.com 
Content-Type: application/x-www-form-urlencoded 
Content-Length: length 

token=string&trajectCode=string
HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<string xmlns="http://www.idiligo.com/">long</long>


4. Connect the participant to the online meeting


To connect the participant to the online meeting you need the security token, the non-public online meeting ID (call ID), and the participant ID (contactID).


HTTP GET
GET /InsideService20.asmx/SetContact?token=string&callID=string&contactId=string HTTP/1.1 
Host: app.idiligo.com
HTTP/1.1 200 OK 
HTTP POST
POST /InsideService20.asmx/SetContact HTTP/1.1 
Host: app.idiligo.com 
Content-Type: application/x-www-form-urlencoded 
Content-Length: length 

token=string&callId=string&contactId=string
HTTP/1.1 200 OK 


5. Generate the URL for the organizer of the meeting


In order for the organizer to go to the meeting, an URL should be created. You need the security token (token) and the non-public call ID (callId).
Please note that for the participant a different URL applies (see point 6).


HTTP GET
GET /InsideService20.asmx/NavigateToAgentUrl?token=string&callID=string&returnUrl=string HTTP/1.1 
Host: app.idiligo.com
HTTP/1.1 200 OK 
HTTP POST
POST /InsideService20.asmx/GetPublicCallId HTTP/1.1 
Host: app.idiligo.com 
Content-Type: application/x-www-form-urlencoded 
Content-Length: length 

token=string&callId=string&returnUrl=string
HTTP/1.1 200 OK 


6. Generate the URL for the participant of the meeting (public ID)


In order for the participant to join the meeting, an URL should be created. You can construct the URL using the Public ID. The URL for joining the online meeting is: https://app.idiligo.com/client?id=[publicID]. This request generates the Public ID. You need the security token and the non-public call ID.
Please note that for the organizer of the meeting a different URL applies (see point 5).


HTTP GET
GET /InsideService20.asmx/GetPublicCallId?token=string&callID=string HTTP/1.1 
Host: app.idiligo.com
HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<string xmlns="http://www.idiligo.com/">string</string>

HTTP POST
POST /InsideService20.asmx/GetPublicCallId HTTP/1.1 
Host: app.idiligo.com 
Content-Type: application/x-www-form-urlencoded 
Content-Length: length 

token=string&callId=string
HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<string xmlns="http://www.idiligo.com/">string</string>


7. Optional: prefill your online meeting with values from your application


Optionally, you can prefill the online meeting with data from your application.


HTTP GET
GET /InsideService20.asmx/Login?apikey=string&username=string&password=string HTTP/1.1 
Host: app.idiligo.com
HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<string xmlns="http://www.idiligo.com/">string</string>

HTTP POST
POST /InsideService20.asmx/Login HTTP/1.1 
Host: app.idiligo.com 
Content-Type: application/x-www-form-urlencoded 
Content-Length: length 

apikey=string&username=string&password=string
HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<string xmlns="http://www.idiligo.com/">string</string>


8. Optional: add a document to your online meeting

You can add documents to your online meetings in 2 steps.
Step 1: uploading the document to Idiligo


HTTP GET
GET /InsideService20.asmx/AddDocumentFromUrl?token=string&apm;url=string&filename=string&externalId=string HTTP/1.1 HTTP/1.1 
Host: app.idiligo.com
HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<long xmlns="http://www.idiligo.com/">long</long>

HTTP POST
POST /InsideService20.asmx/AddDocumentFromUrl HTTP/1.1 
Host: app.idiligo.com 
Content-Type: application/x-www-form-urlencoded 
Content-Length: length 

token=string&url=string&filename=string&externalId=string
HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<long xmlns="http://www.idiligo.com/">long</long>



Step 2: adding the uploaded document to an online meeting


HTTP GET
GET /InsideService20.asmx/AddDocumentToCall?token=string&callId=string&documentId=string&nodeCode=string HTTP/1.1 HTTP/1.1 
Host: app.idiligo.com
HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<long xmlns="http://www.idiligo.com/">long</long>

HTTP POST
POST /InsideService20.asmx/AddDocumentToCall HTTP/1.1 
Host: app.idiligo.com 
Content-Type: application/x-www-form-urlencoded 
Content-Length: length 

token=string&callId=string&documentId=string&nodeCode=string
HTTP/1.1 200 OK 
Content-Type: text/xml; charset=utf-8 
Content-Length: length 

<?xml version="1.0" encoding="utf-8"?> 
<long xmlns=""http://www.idiligo.com/">long</long>


For a complete overview of all types of requests:
http://app.idiligo.com/insideservice20.asmx