{"id":23139037,"url":"https://github.com/circuit/hubot-circuit","last_synced_at":"2025-08-17T11:33:26.379Z","repository":{"id":57268777,"uuid":"92727957","full_name":"circuit/hubot-circuit","owner":"circuit","description":"Hubot adapter for Circuit","archived":false,"fork":false,"pushed_at":"2017-08-09T16:41:53.000Z","size":13,"stargazers_count":5,"open_issues_count":0,"forks_count":4,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-12-01T22:28:46.151Z","etag":null,"topics":["circuit","hubot-adapter"],"latest_commit_sha":null,"homepage":null,"language":"CoffeeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/circuit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-05-29T10:04:57.000Z","updated_at":"2019-02-05T15:11:36.000Z","dependencies_parsed_at":"2022-09-02T05:40:10.934Z","dependency_job_id":null,"html_url":"https://github.com/circuit/hubot-circuit","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/circuit%2Fhubot-circuit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/circuit%2Fhubot-circuit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/circuit%2Fhubot-circuit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/circuit%2Fhubot-circuit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/circuit","download_url":"https://codeload.github.com/circuit/hubot-circuit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230121628,"owners_count":18176477,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["circuit","hubot-adapter"],"created_at":"2024-12-17T13:13:07.101Z","updated_at":"2024-12-17T13:13:07.803Z","avatar_url":"https://github.com/circuit.png","language":"CoffeeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hubot-circuit\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![CircleCI](https://circleci.com/gh/circuit/hubot-circuit.svg?style=shield)](https://circleci.com/gh/circuit/hubot-circuit)\n[![Coverage Status](https://coveralls.io/repos/github/circuit/hubot-circuit/badge.svg)](https://coveralls.io/github/circuit/hubot-circuit)\n[![Dependency Status](https://gemnasium.com/badges/github.com/circuit/hubot-circuit.svg)](https://gemnasium.com/github.com/circuit/hubot-circuit)\n\n\n## Description\nThis is the [Circuit](http://circuit.com) adapter for [hubot](http://hubot.github.com). Now, you can create your own bots in Circuit and have them easily configured through hubot.\n\n#### Configuration\n\n* Start by creating a [bot application](https://hubot.github.com/docs/#getting-started-with-hubot)\n* Create a Circuit client credentials application\n* Get the **client_id** and **client_secret**\n* Export necessary environment variables. The Circuit adapter requires 3 environment variables:\n\n```\nexport HUBOT_CIRCUIT_CLIENT_ID=\"YOUR_CIRCUIT_CLIENT_ID\"\nexport HUBOT_CIRCUIT_CLIENT_SECRET=\"YOUR_CIRCUIT_CLIENT_SECRET\"\nexport HUBOT_CIRCUIT_WEBHOOKS_URL=\"YOUR_APP_URL\"\n```\nThe following are optional:\n```\nexport HUBOT_CIRCUIT_REST_API_URL=\"CIRCUIT_REST_API_URL\"\nexport HUBOT_CIRCUIT_ADDRESS=\"YOUR_APP_ADDRESS\"\nexport HUBOT_CIRCUIT_PORT=\"YOUR_APP_PORT\"\nexport HUBOT_CIRCUIT_SCOPE=\"YOUR_APP_SCOPE\"\n```\nIf you do not specify the optional parameters above the default ones will be loaded.\n```\nHUBOT_CIRCUIT_ADDRESS=\"0.0.0.0\"\nHUBOT_CIRCUIT_PORT=\"8181\"\nHUBOT_CIRCUIT_REST_API_URL=\"https://eu.yourcircuit.com/rest\"\nHUBOT_CIRCUIT_SCOPE=\"ALL\"\n```\n\n#### Run hubot\n```\n./bin/hubot -a circuit\n```\n\nhubot-circuit uses [Rest API](https://eu.yourcircuit.com/rest/swagger/ui/index.html) and webhooks in order to communicate with Circuit. The default events that are registered through webhooks are the CONVERSATION.ADD_ITEM and CONVERSATION.UPDATE_ITEM. In order to receive events the callback url (HUBOT_CIRCUIT_WEBHOOKS_URL) that you will use must be a secure url.\n\n###### Certificates\n\nWhen you load hubot-circuit adapter, an express https server will start up on 443 port. In order for the https server to start up place the certificate files, named 'key.pem' and 'cert.pem', in the root folder of your application.\n\n\nIf you have not provided any certificates an http server will start up on 8181 port.\n\n**Note:** Hubot starts a server on the address and port you have specified with the corresponding env variables (EXPRESS_BIND_ADDRESS and EXPRESS_PORT) or 0.0.0.0 and 8080, otherwise. If you do not plan to use robot.router in your scripts, you can disable the embedded hubot express server, simply by running\n\n```\n./bin/hubot -d -a circuit\n```\n\nOtherwise, you will have two servers running on 8080 and on 8181.\n\n#### How do I get set up?\n\n\n* Install dependencies with\n```\nnpm install\n```\n* Run tests\n```\nnpm test\n```\n\n#### Contribution guidelines\n\n* Fork the project\n* Clone your fork\n* Create a feature branch\n* Develop your feature\n* Write tests\n* Make sure everything still passes by running tests\n* Make sure you have followed coffeescript's syntax [coffeelint](http://www.coffeelint.org/)\n* Make sure coverage is not decreased\n* Push your changes\n* Send a pull request for your branch\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcircuit%2Fhubot-circuit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcircuit%2Fhubot-circuit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcircuit%2Fhubot-circuit/lists"}