{"id":23176164,"url":"https://github.com/nexmo-community/nexmo-slack-bot","last_synced_at":"2025-09-25T09:42:34.039Z","repository":{"id":66085198,"uuid":"89082040","full_name":"nexmo-community/nexmo-slack-bot","owner":"nexmo-community","description":"nexmobot is Slack bot offering communications functionality using Nexmo","archived":false,"fork":false,"pushed_at":"2025-04-30T10:40:11.000Z","size":443,"stargazers_count":0,"open_issues_count":15,"forks_count":5,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-04-30T12:00:46.306Z","etag":null,"topics":["bots","communications","nexmo","slack","slack-bot","slackbot"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/nexmo-community.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-04-22T16:03:48.000Z","updated_at":"2023-03-16T21:27:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"2a654c6e-a404-4ac7-834d-565f4a3e172f","html_url":"https://github.com/nexmo-community/nexmo-slack-bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nexmo-community/nexmo-slack-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexmo-community%2Fnexmo-slack-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexmo-community%2Fnexmo-slack-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexmo-community%2Fnexmo-slack-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexmo-community%2Fnexmo-slack-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nexmo-community","download_url":"https://codeload.github.com/nexmo-community/nexmo-slack-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexmo-community%2Fnexmo-slack-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276896554,"owners_count":25724047,"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","status":"online","status_checked_at":"2025-09-25T02:00:09.612Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["bots","communications","nexmo","slack","slack-bot","slackbot"],"created_at":"2024-12-18T06:15:33.385Z","updated_at":"2025-09-25T09:42:34.033Z","avatar_url":"https://github.com/nexmo-community.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nexmo Slack Bot\n\nA Slack bot offering communications functionality using Nexmo\n\n![nexmobot example](nexmobot.gif)\n\n## Prerequisites\n\n* Install and setup the [nexmo-cli](https://github.com/nexmo/nexmo-cli)\n* Get a [Nexmo account](https://dashboard.nexmo.com/sign-up)\n* Create a new [bot user](https://api.slack.com/bot-users) in Slack and take a note of the Slack bot token\n\n## Install\n\nClone the repo and install dependencies\n\n```\ngit clone git@github.com:nexmo-community/nexmo-slack-bot.git\ncd nexmo-slack-bot\nnpm install\n```\n\nCreate a Nexmo application and take a note of the application ID that is output (referred to as `NEXMO_APP_ID` below)\n\n```sh\nnexmo app:create \"nexmobot\" https://example.com https://example.com --type=voice --keyfile=private.local.key\n```\n\nBuy a phone number and take a note of the number (referred to as `PHONE_NUMBER` below)\n\n```sh\nnexmo number:buy US --confirm\n```\n\nLink the number to the application you created\n\n```sh\nnexmo link:app PHONE_NUMBER NEXMO_APP_ID\n```\n\nCreate a `.env` file with the following entries\n\n```\nSLACK_BOT_TOKEN=\nSLACK_BOT_PHONE_NUMBERS=PHONE_NUMBER\nNEXMO_API_KEY=\nNEXMO_API_SECRET=\nNEXMO_APP_ID=NEXMO_APP_ID\nBASE_URL=\n```\n\n## Running the Nexmo Slack Bot\n\nRunning locally using Heroku toolbelt\n\n```sh\n$ env NEXMO_PRIVATE_KEY=\"`cat private.local.key`\" heroku local\n```\n\nRunning locally using foreman\n\n```sh\n$ env NEXMO_PRIVATE_KEY=\"`cat private.local.key`\" foreman start\n```\n\n## Usage\n\n### `conference participants`\n\nInvite participants by directly providing their phone number\n\n```sh\n@nexmobot please create a conference call with 14155550123 and 14155550456\n```\n\n## Deploying to Heroku\n\nCreate a new Heroku application and take a note of the URL for the new app.\n\n```sh\nheroku apps:create {name}\n```\n\nIt's recommended to create a separate Nexmo application for your Heroku deployment. To create a new application use and take a note of the applicaiton ID (referred to as `NEXMO_APP_ID` below)\n\n```\nnexmo app:create \"Live nexmobot\" HEROKU_URL/answer HEROKU_URL/events --type=voice --keyfile=private.heroku.key\n```\n\nBuy a phone number for your live bot (referred to as `NEXMO_PHONE_NUMBER` below)\n\n```sh\nnexmo number:buy US --confirm\n```\n\nLink the number to the application you created\n\n```sh\nnexmo link:app PHONE_NUMBER NEXMO_APP_ID\n```\n\nUpdate the configuration for the Heroku application\n\n```sh\nheroku config:set \\\nSLACK_BOT_TOKEN=SLACK_BOT_TOKEN\nSLACK_BOT_PHONE_NUMBERS={NEXMO_PHONE_NUMBER\nNEXMO_APP_ID=NEXMO_APP_ID \\\nNEXMO_API_KEY=API_KEY \\\nNEXMO_API_SECRET=API_SECRET \\\nBASE_URL=HEROKU_URL \\\nNEXMO_PRIVATE_KEY=\"$(cat private.heroku.key)\"\n```\n\n*Note: the `HEROKU_URL` should not contain a trailing slash*\n\nPush your code to Heroku\n\n```sh\ngit push heroku master\n```\n \n\n## Running the Tests\n\n```sh\n$ ava test/*\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnexmo-community%2Fnexmo-slack-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnexmo-community%2Fnexmo-slack-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnexmo-community%2Fnexmo-slack-bot/lists"}