Slack

Examples

Setup

1. 1

   Create the app from a manifest

   Go to api.slack.com/apps → Create New App → From a manifest, pick your workspace, and paste this manifest.

   {
     "display_information": {
       "name": "Rate-API",
       "description": "Live currency exchange rates and conversion, right inside Slack.",
       "background_color": "#0b1120"
     },
     "features": {
       "bot_user": { "display_name": "Rate-API", "always_online": true },
       "slash_commands": [
         {
           "command": "/rate",
           "url": "https://new.rate-api.com/integrations/slack",
           "description": "Get an exchange rate or convert an amount",
           "usage_hint": "100 USD to EUR",
           "should_escape": false
         }
       ]
     },
     "oauth_config": { "scopes": { "bot": ["commands"] } },
     "settings": { "org_deploy_enabled": false, "socket_mode_enabled": false, "token_rotation_enabled": false }
   }

2. 2

   Install it to your workspace

   Create the app, then click Install to Workspace and approve.

3. 3

   Set the signing secret

   Copy Basic Information → Signing Secret, then on the Rate-API server add it to .env and re-cache config. Until this is set the command safely returns “not configured”.

   SLACK_SIGNING_SECRET=your_signing_secret_here
   php artisan config:cache

4. 4

   Try it

   In any channel, run /rate 100 USD to EUR.

Endpoint

Verified by the platform’s request signature. It safely returns “not configured” until its secret is set on the server.