Getting started

Guuru enables you to integrate in-house or 3rd party software with our platform to gain access to leads, customers interactions and chats from anywhere.

Why Guuru is using GraphQL

Guuru choose GraphQL for our API because it offers significantly more flexibility for our integrators. The ability to define precisely the data you want — and only the data you want — is a powerful advantage.

The GraphQL Endpoint

The GraphQL Admin API has a single endpoint:

https://api.guuru.com/graphql

Authentication

The GraphQL Admin API requires an access token for making authenticated requests.

To obtain an access token visit the Partner Portal and create a new API token:

  1. From partner portal, click on the Developer page under Settings in the left menu.
  2. Click Create API Key.
  3. Enter a small description to identify your key.
  4. Click Create & View.
  5. Copy the generated API key as the access token.

For security reasons, we cannot show it to you again, copy the key and save it somewhere safe.

Using your access token

Include the access token as a Authorization header in all GraphQL queries and mutations.

Query the GraphQL Admin API

You can access the GraphQL Admin API endpoint using cURL or any other HTTP client. For the following examples, make sure to replace <ACCESS_TOKEN> with the token you generated in the Authentication section.

Using curl

To make a query with curl, do a POST request and include your query as a JSON payload.

curl 'https://api.guuru.com/graphql' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-d @- << EOF
{"query":"{
  partner{
    state{
      chat{
        isAvailable
      }
    }
  }
}"}
EOF
← Getting StartedExamples →