Skip to main content

Overview

This integration posts a message to a Slack channel when a quote is signed in Qwoty. Optionally, it also uploads the quote PDF to the same channel.

Authentication

You need a Slack Bot Token (xoxb-...) to authenticate requests.
  1. Go to api.slack.com/appsCreate New AppFrom scratch
  2. Under OAuth & Permissions, add the following Bot Token Scopes:
    • chat:write — to post messages
    • files:write — to upload PDFs
  3. Click Install to Workspace, then copy the Bot User OAuth Token
  4. Invite the bot to your target channel: /invite @YourAppName
The bot must be invited to the channel before it can post messages or upload files. API calls will return not_in_channel otherwise.
Use the Channel ID rather than the channel name (e.g. C0123ABC456). Find it by clicking the channel name → About tab → bottom of the panel.

Settings

KeyDefaultDescription
tokenSlack Bot Token (xoxb-...). Required.
message_channelTarget channel ID or name. Required.
document_sendtrueUpload the quote PDF to the channel.

Output

Message

A message is posted in the configured channel

**Example (EN):**
BREAKING NEWS : Edouard just signed ACME for a total of 7,572.20.


### PDF upload

If **Send document** is enabled the PDF is uploaded to the same channel.

The file is named: `YYYYMMDD-CompanyName.pdf