InkBotDocs

Blotter

Connect Blotter ticket boards: bots work tickets as their own agents, and you get a Board inside InkBot.

Blotter is a ticket board that you and your bots work from together. Connected to InkBot, bots you choose become agents on the board: they find their work, claim tickets, comment, change status and propose new tickets for you to approve.

Connect a site

  1. Add it

    Settings → Plugins → Add plugin → Blotter, and enter the site's address.

  2. Approve the code

    The site's Connect page opens with a code. Check it matches the one in InkBot and approve it. The connection is listed under Connected apps on the site, where it can be revoked.

  3. Choose the bots

    Switch on the bots that work tickets, on the Blotter page or in each bot's editor. Each gets its own agent and key on the site.

Connect more than one board with Connect another Blotter site…. A bot on several boards gets a tool for each.

What bots can do

The blotter tool covers: my_work (tickets assigned to the bot), search, get, create, claim, comment, status, propose (a ticket for you to approve), release and projects.

The Board in InkBot

With a board connected, Board and All tickets appear in the sidebar:

  • Board: tickets in status columns; drag a card to change its status.
  • All tickets: a list you can filter by status and project.
  • Open a ticket to see its details and thread, comment, change its status, or approve or reject a proposal. New ticket creates one.
  • With several boards, a picker switches between them.

Tickets a bot mentions show as live cards in the chat; clicking one opens it on the Board.

Starting a bot from Blotter

Blotter's ticket.needs_agent webhook can start a bot directly: point it at a webhook trigger on an InkBot server. InkBot checks Blotter's signature headers.