{"id":17760747,"url":"https://github.com/tzmfreedom/hubot-chatter","last_synced_at":"2025-05-12T18:47:27.762Z","repository":{"id":21831812,"uuid":"25154836","full_name":"tzmfreedom/hubot-chatter","owner":"tzmfreedom","description":"Chatter adapter for Hubot","archived":false,"fork":false,"pushed_at":"2015-02-05T06:08:25.000Z","size":171,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-20T01:19:31.620Z","etag":null,"topics":["coffeescript","hubot","salesforce"],"latest_commit_sha":null,"homepage":null,"language":"CoffeeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tzmfreedom.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-10-13T10:53:35.000Z","updated_at":"2024-01-27T21:29:20.000Z","dependencies_parsed_at":"2022-08-20T00:00:41.072Z","dependency_job_id":null,"html_url":"https://github.com/tzmfreedom/hubot-chatter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzmfreedom%2Fhubot-chatter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzmfreedom%2Fhubot-chatter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzmfreedom%2Fhubot-chatter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzmfreedom%2Fhubot-chatter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tzmfreedom","download_url":"https://codeload.github.com/tzmfreedom/hubot-chatter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253802467,"owners_count":21966808,"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":["coffeescript","hubot","salesforce"],"created_at":"2024-10-26T19:11:47.317Z","updated_at":"2025-05-12T18:47:27.391Z","avatar_url":"https://github.com/tzmfreedom.png","language":"CoffeeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hubot Chatter Adapter\n[![Build Status](https://travis-ci.org/tzmfreedom/hubot-chatter.svg?branch=master)](https://travis-ci.org/tzmfreedom/hubot-chatter)\n\n## Description\nThis is [Chatter](http://www.salesforce.com/jp/chatter/overview/) adapter for hubot.\n\n## Installation and Setup\n\n1.　Add hubot-chatter to dependencies in your hubot's package.json.  \n\n```\n\"dependencies\": {\n    \"hubot-chatter\": \"0.0.2\",\n    \"hubot\": \"~2.8.2\"\n}\n```\n\n2.　Install hubot-chatter  \n ```bash\nnpm install\n```\n\n3.　Set environment variables.  \n ``` bash\nexport HUBOT_SFDC_USERNAME=\"input hubot user's username\"\nexport HUBOT_SFDC_PASSWORD=\"input hubot user's password\"\n```\n\n4.　Run hubot with chatter adapter.  \n ```bash\nbin/hubot -a chatter\n```\n\n## Usage\nThe chatter adapter requires only the following environment variables.\n\n* HUBOT_SFDC_USERNAME\n* HUBOT_SFDC_PASSWORD\n\nAnd the following are optional.\n\n* HUBOT_SFDC_LOGINURL\n* HUBOT_SFDC_API_VERSION\n* HUBOT_SFDC_QUERY_OBJECT\n* HUBOT_SFDC_POLLING_TYPE\n* HUBOT_SFDC_TOPIC\n* HUBOT_SFDC_POLLING_INTERVAL\n* HUBOT_SFDC_PARENT_ID\n\n#### HUBOT_SFDC_USERNAME\nThis is the username for your chatter bot.\n\n#### HUBOT_SFDC_PASSWORD\nThis is the password for your chatter bot.\n\n#### HUBOT_SFDC_LOGINURL\nThis is the salesforce login server URL(e.g. 'https://login.salesforce.com/')  \nIf not specified, this value defaults to \"https://login.salesforce.com\".  \nSet to \"https://test.salesforce.com\", when you want your hubot to connect to sandbox.\n\n#### HUBOT_SFDC_API_VERSION\nThis is the salesforce API version.  \nIf not specified, this value defaults to \"30.0\".\n\n#### HUBOT_SFDC_QUERY_OBJECT\nThis is the chatter object which you want to monitor and post.\n\n#### HUBOT_SFDC_POLLING_TYPE\nThis is the method for monitoring chatter objects.  \nSet to \"streaming\", when you want to use StreamingAPI to monitor chatter objects.  \nSet to \"query\", when you want to use SOQL and polling to monitor chatter objects.  \nIf not specified, this value defaults to \"query\".\n\n#### HUBOT_SFDC_TOPIC\nThis is the topic name to subscribe for StreamingAPI.  \nSet to the target topic name, when you want to use StreamingAPI (HUBOT_SFDC_POLLING_TYPE='streaming').\n\n#### HUBOT_SFDC_PARENT_ID\nThis is the parent ID which your hubot moniters and posts feeds to(e.g. Chatter Group ID).  \nIf not specified, your hubot monitors and posts feeds to user account(refered by HUBOT_SFDC_USERNAME).\n\n#### HUBOT_SFDC_POLLING_INTERVAL\nThis is the number of milliseconds to wait between attempts when polling for results of the query result.  \nIf not specified, this value defaults to 60,000(1min).\n\n\n## StreamingAPI\nIf you want to use StreamingAPI for monitoring chatter feeds,\nPlease implement 4 custom text fields for target Object.\nThese fields mean following below.\n\n* User__c: Salesforce UserId.\n* ParentId__c: Related User/Group/Record ID.\n* Body__c: Message Body.\n* FeedItemId__c: Parent FeedItem ID.\n\n## Sample\n\n#### Using SOQL polling\n```bash\nexport HUBOT_SFDC_USERNAME=user@example.com\nexport HUBOT_SFDC_PASSWORD=hogefuga\n```\n\n#### Using StreamingAPI\n```bash\nexport HUBOT_SFDC_USERNAME=user@example.com\nexport HUBOT_SFDC_PASSWORD=hogefuga\nexport HUBOT_SFDC_POLLINGTYPE=streaming\nexport HUBOT_SFDC_TOPIC=AllMessages\n```\n\n#### Connect to Sandbox with setting to 5minutes for polling interval\n```bash\nexport HUBOT_SFDC_USERNAME=user@example.com.sandbox\nexport HUBOT_SFDC_PASSWORD=hogefuga\nexport HUBOT_SFDC_LOGINURL=https://test.salesforce.com\nexport HUBOT_SFDC_POLLING_INTERVAL=300000\n```\n\n#### Monitoring and Posting FeedComment Object\n```bash\nexport HUBOT_SFDC_USERNAME=user@example.com\nexport HUBOT_SFDC_PASSWORD=hogefuga\nexport HUBOT_SFDC_QUERY_OBJECT=FeedComment\n```\n\n#### Monitoring and Posting The Record/Group Feed\n```bash\nexport HUBOT_SFDC_USERNAME=user@example.com\nexport HUBOT_SFDC_PASSWORD=hogefuga\nexport HUBOT_SFDC_PARENT_ID=001A0000019n4FhIAI #Account Feed\n#export HUBOT_SFDC_PARENT_ID=0F9A0000000HZKUKA4 #Group Feed\n```\n\n## Contribute\nJust send pull request if needed or fill an issue!\n\n## License\nThe MIT License See [LICENSE](https://github.com/tzmfreedom/hubot-chatter/blob/master/LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftzmfreedom%2Fhubot-chatter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftzmfreedom%2Fhubot-chatter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftzmfreedom%2Fhubot-chatter/lists"}