Start

This is the first API call you must make to start a conversation with Socrates. You will need to supply a username and password, unique to every survey and supplied in advance by Quester.

If your username and password are accepted, you will be given a conversation token. This token must be used throughout the rest of your conversation with Socrates.

URL https://www.socratesinsights.com/api/conversation/start
HTTP Method(s) POST

Example Request

<?xml version="1.0" encoding="UTF-8"?>
<conversation>
    <projectId>flGNpfoYD6rTrIE--SiFkg8JabMG9k3c</projectId>
</conversation>
Parameters
projectId required. A string which uniquely identifies the project which the ITB will access.

Example Response (valid request)

<?xml version="1.0" encoding="UTF-8"?>
<conversation>
    <token>XYZ123456</token>
</conversation>

Example Response (invalid request)

<?xml version="1.0" encoding="UTF-8"?>
<conversation>
    <error>
        <message>Incorrect Username or Password</message>
    </error>
</conversation>
Parameters
token This is the unique identifier which must be used to continue the conversation.
error > message This appears should you supply an incorrect projectId.