Hello Interactor
Now that INTERACTOR ENGINE has been deployed, you can say hello to INTERACTOR and integrate with your user's external connector by following the following steps. For this, we will assume that your user's user id is managed by their email address, for example, john@example.com.
User Authorization.
User first has to authorize Interactor access to the external connector. In this case, we are using Gmail connector as an example. This will use INTERACTOR's default registered application with Gmail.
This example also assumes INTERACTOR is installed on your laptop, accessible by address localhost and configured to use the default port 1290.
Default authorization method is api_key for unlicensed use with key value being default.
curl --location 'http://localhost:1290/v1/connector/gmail/oauth?userId=john@example.com' --header 'api_key: default'
The user may approve the authorization request using the url returned in the response of above request
https://accounts.google.com/o/oauth2/v2/auth?prompt=consent&access_type=offline&include_granted_scopes=true&response_type=code&redirect_uri=https%3A%2F%2Fproxy.interactor.com%3A4443%2Fplatform%2FUNLICENSED%2Foauth&state=XCP._RfTINH6wTFYYoFr-tY6S7HrF5FkRtoGSVl-DD4LkBAbjnVK2HKysdWKCXhMeB0Jh2FapD8AdeIeFfiqRwYgCJp3a08QzUol74FO4av8TWd2FyWrkG5vq2UXrnumX1SqBHNRLfLDet3HuhjaGE8r4LX9BgpNwLgdT-abrLd35PwQm2XelUlUyv3a9j0bWNPKlXLp2bqhgdJBiIgqc8wb5nbgWazoh02Qw3L1C8tIWwyaOuLZYxc1xf-oeDx1bQYkUUEQGPK6ip2mcXwA4KskuNWKqC_mAICrnvsLTAZ-xR80za7AJUBZmJAFIRRHB7Kex3E&client_id=160246500491-c0673sd3ilfnl7hv0s6qvrcl5n302ilb.apps.googleusercontent.com&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fuserinfo.email+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fgmail.labels+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fgmail.send
Call external connector
Once authorization process has been completed, you may integrate with your user's external connector using one of the many actions that are either built-in to INTERACTOR or made available by the community.
curl --location 'http://localhost:1290/v1/connector/gmail/action/email.send/execute?userId=john@example.com' \
--header 'Content-Type: application/json' \
--header 'api_key: default' \
--data-raw '{"to" : [abc@example.com] "subject" : "test", "body subject" : "test body"}'