Intro shape

Develop on the top of giosg
platform!

We are proud of our platform to create only meaningful interactions. Everyone is invited to use and innovate on top of it.

Easy to get started
Box 1 image
Integrate

Create a giosg account and add giosg script to your web page if you are planning to create web interactions.

Box 2 image
Implement

Giosg can work with other systems via giosg apps. You can add interactions from other sources and push data from giosg to your existing systems. Data between your system and giosg is shared via webhooks.

Box 3 image
Innovate

We do not try to invent everything in house. Use for example our communication platform to create an AI powered chatbots to help serve millions of customers simultaneously.

What are giosg apps?

Giosg apps allow 3rd parties (and us!) to develop on top of giosg platform. Inside giosg an app is basically just a configuration, a set of webhooks and triggers which are triggered when state changes in giosg. The app instance is a web service receiving state changes and calling giosg through its REST API. The instance can be running anywhere where it is accessible by HTTPS. An app can be a visual component in giosg console and/or a background service enriching the interactions.

The apps can be configured to be private or public. Private app can be used only in your own organization. Public means it is shared to your organization partner network. If you want to share your app with the world you can contact support@giosg.com.

How does it work?

Hooks & triggers

Webhooks and triggers are the communication method of giosg and the apps. Webhooks are reactions to any change in giosg, for example when a chat begins or new user is added to your organization. Triggers make it possible to start an app directly from the user’s browser; as a new page, embedded as iframe or as and Ajax request from the UI.

APIs

Giosg exposes REST API to fetch and update its state. The authentication and authorization can be done by using generated API token generated for server-server connections or OAuth2 grants using implicit or authorization code flow for web apps.

Bot users

Every may have a bot user. A bot user is like any other user in giosg, excluding password and email. A bot user is required if the app works independently, like for example a chatbot answering to customers’ questions.

Frequently asked questions
How do I start?
Sign up to free trial in giosg.com and add giosg script to your site.
How much does it cost?

Developing apps is free, testing the app is free and it is free to publish your app for 30 days. If you want to continue after free trial you should contact support@giosg.com for further instructions.

Where is the API documentation?

All the APIs are documented at https://developers.giosg.com

How do I develop locally?

You cannot use localhost as the address for the app as giosg needs to be able to connect to your app. You can use tunneling service like https://ngrok.io or https://serveo.net to expose your local development version to giosg.

Is there any reference apps with source code?

Yes we have a demo bot written in Python. The bot automatically joins a chat and sends buttons containing links to different topics. It can also invite people to the chat. The bot can be found from Github (link to https://github.com/giosg/demo-bot)

Can giosg host my app?
Giosg does not provide hosting for external app developers.
How an app is installed?
If you have developed the app by yourself you can install the app vie settings page. If you have networked with another giosg account you share the app with the networked account. The account admin can then install the app again in settings page.