RingCentral Engage SDK for Go

Overview

This currently provides a minimal Go SDK for RingCentral Engage Digital, formerly Dimelo:

https://www.dimelo.com

Pre-requisites

You need the following:

1. RingCentral Engage Digital / Dimelo Account and the URL subdomain, e.g. my-subdomain in the following URL: https://my-subdomain.engagement.dimelo.com
2. An API Access Token. You can retrive this at the following URL, using your own domain in place of my-subdomain: https://my-subdomain.engagement.dimelo.com/admin/api_access_tokens

Installation

$ go get github.com/grokify/go-ringcental-engage/...

Usage

The main SDK is in the engagedigital/engagedigital folder. The engagedigital/engagedigitalutil folder provides a non-autogenerated helper function to instantiate the SDK:

import("github.com/grokify/go-ringcentral-engage/engagedigital/engagedigitalutil")

func main() {
    apiClient := engagedigitalutil.NewApiClient("my-subdomain", "my-access-token")

    // helper function to get access to raw `*http.Client`
    httpClient := apiClient.HTTPClient()
}

For information on how to use the apiClient object, see:

1. engagedigital/examples folder for usage. engagedigital/examples/simple_get includes a simple functions for a lot of the GET APIs.
2. engagedigital/engagedigital/README.md for SDK documentation.

Documentation

engagedigital/engagedigital/README.md

Coverage

116/121 APIs - 96%

• [x] Communities

  • [x] GET /1.0/communities
  • [x] GET /1.0/communities/:id

• [x] Sources

  • [x] GET /1.0/content_sources
  • [x] GET /1.0/content_sources/:id
  • [x] PUT /1.0/content_sources/:id

• [x] Folders

  • [x] GET /1.0/folders
  • [x] GET /1.0/folders/:id
  • [x] POST /1.0/folders
  • [x] PUT /1.0/folders/:id
  • [x] DELETE /1.0/folders/:id

• [x] Roles

  • [x] GET /1.0/roles
  • [x] GET /1.0/roles/:id
  • [x] POST /1.0/roles
  • [x] PUT /1.0/roles/:id

• [x] Categories

  • [x] GET /1.0/categories
  • [x] GET /1.0/categories/:id
  • [x] POST /1.0/categories
  • [x] PUT /1.0/categories/:id
  • [x] DELETE /1.0/categories/:id

• [x] Tags

  • [x] GET /1.0/tags
  • [x] GET /1.0/tags/:id
  • [x] POST /1.0/tags
  • [x] PUT /1.0/tags/:id
  • [x] DELETE /1.0/tags/:id

• [x] Teams

  • [x] GET /1.0/teams
  • [x] GET /1.0/teams/:id
  • [x] POST /1.0/teams
  • [x] PUT /1.0/teams/:id
  • [x] DELETE /1.0/teams/:id

• [x] Users

  • [x] GET /1.0/users/me
  • [x] GET /1.0/users
  • [x] GET /1.0/users/:id
  • [x] POST /1.0/users
  • [x] PUT /1.0/users/:id
  • [x] POST /1.0/users/invite
  • [x] DELETE /1.0/users/:id

• [ ] User Source Permissions

  • [ ] GET /1.0/users/:id/sources_permissions
  • [ ] PUT /1.0/users/:id/sources_permissions

• [x] Identities

  • [x] GET /1.0/identities
  • [x] GET /1.0/identities/:id

• [x] Identity Groups

  • [x] GET /1.0/identity_groups
  • [x] GET /1.0/identity_groups/:id
  • [x] PUT /1.0/identity_groups/:id

• [x] Custom Fields

  • [x] GET /1.0/custom_fields
  • [x] GET /1.0/custom_fields/:id
  • [x] POST /1.0/custom_fields
  • [x] PUT /1.0/custom_fields/:id
  • [x] DELETE /1.0/custom_fields/:id

• [x] Threads

  • [x] GET /1.0/content_threads
  • [x] GET /1.0/content_threads/:id
  • [x] PUT /1.0/content_threads/:id/update_categories
  • [x] PUT /1.0/content_threads/:id/ignore
  • [x] PUT /1.0/content_threads/:id/close
  • [x] GET /1.0/content_threads/:id/open

• [x] Contents

  • [x] GET /1.0/contents
  • [x] GET /1.0/contents/:id
  • [x] POST /1.0/contents
  • [x] PUT /1.0/contents/:id/update_categories
  • [x] PUT /1.0/contents/:id/ignore

• [x] Attachments

  • [x] GET /1.0/attachments
  • [x] GET /1.0/attachments/:id
  • [x] POST /1.0/attachments

• [x] Events

  • [x] GET /1.0/events
  • [x] GET /1.0/events/:id

• [ ] Interventions

  • [x] GET /1.0/interventions
  • [x] GET /1.0/interventions/:id
  • [x] POST /1.0/interventions
  • [ ] PUT /1.0/interventions/:id
  • [x] PUT /1.0/interventions/:id/close
  • [x] PUT /1.0/interventions/:id/reassign
  • [x] PUT /1.0/interventions/:id/update_categories
  • [x] DELETE /1.0/interventions/:id/cancel

• [x] Intervention comments

  • [x] GET /1.0/intervention_comments
  • [x] GET /1.0/intervention_comments/:id
  • [x] POST /1.0/intervention_comments
  • [x] DELETE /1.0/intervention_comments/:id

• [x] Agent Status (task view)

  • [x] GET /1.0/status
  • [x] GET /1.0/status/:agent_id
  • [ ] PUT /1.0/status/:agent_id

• [x] Webhook

  • [x] GET /1.0/webhooks
  • [x] GET /1.0/webhooks/:id
  • [x] POST /1.0/webhooks
  • [x] PUT /1.0/webhooks/:id
  • [x] DELETE /1.0/webhooks/:id

• [x] Time Sheet

  • [x] GET /1.0/time_sheets
  • [x] GET /1.0/time_sheets/:id
  • [x] POST /1.0/time_sheets
  • [x] PUT /1.0/time_sheets/:id
  • [x] DELETE /1.0/time_sheets/:id

• [x] Channels

  • [x] GET /1.0/channels
  • [x] GET /1.0/channels/:id
  • [x] PUT /1.0/channels/:id

• [x] Settings

  • [x] GET /1.0/settings
  • [x] PUT /1.0/settings

• [x] Locales

  • [x] GET /1.0/locales

• [x] Timezones

  • [x] GET /1.0/timezones

• [x] Presence statuses

  • [x] GET /1.0/presence_status
  • [x] GET /1.0/presence_status/:id
  • [x] POST /1.0/presence_status
  • [x] PUT /1.0/presence_status/:id
  • [x] DELETE /1.0/presence_status/:id

• [x] Tasks

  • [x] GET /1.0/tasks
  • [x] GET /1.0/tasks/:id
  • [x] POST /1.0/tasks/:id/transfer
  • [x] POST /1.0/tasks/:id/move

• [x] Reply Assistant - Entries

  • [x] GET /1.0/reply_assistant/entries
  • [x] GET /1.0/reply_assistant/entries/:id
  • [x] POST /1.0/reply_assistant/entries
  • [x] PUT /1.0/reply_assistant/entries/:id
  • [x] DELETE /1.0/reply_assistant/entries/:id

• [x] Reply Assistant - Versions

  • [x] GET /1.0/reply_assistant/versions
  • [x] GET /1.0/reply_assistant/versions/:id
  • [x] POST /1.0/reply_assistant/versions
  • [x] PUT /1.0/reply_assistant/versions/:id
  • [x] DELETE /1.0/reply_assistant/versions/:id

• [x] Reply Assistant - Groups

  • [x] GET /1.0/reply_assistant/groups
  • [x] GET /1.0/reply_assistant/groups/:id
  • [x] POST /1.0/reply_assistant/groups
  • [x] PUT /1.0/reply_assistant/groups/:id
  • [x] DELETE /1.0/reply_assistant/groups/:id

• [ ] Survey Response

  • [ ] GET /1.0/survey_responses/:id

There are 127 endpoints. To count, use the following on OS-X:

$ grep ' [ ]' README.md  | wc -l

Building the SDK

You won't normally need to do this unless you want to modify the SDK, like adding endpoints via the OpenAPI 2.0 / Swagger 2.0 specification.

This SDK is auto-generated from the OpenAPI 2.0 / Swagger 2.0 spec using OpenAPI Generator.

Note: This SDK uses a merged OpenAPI spec so do not edit the codegen/openapi-spec.json file. Instead, edit files in and add files to the codegen/partial-specs folder.

Run:

$ cd codegen
$ go run merge.go -v 3
$ sh generate.sh
$ rm -rf ../engagedigital
$ mv engagedigital ..

Credits

Thanks to the following apps for making this possible:

• https://github.com/OpenAPITools/openapi-generator
• https://github.com/getkin/kin-openapi/tree/master/openapi3
• https://apidevtools.org/swagger-parser/online/
• https://mermade.org.uk/openapi-converter