Whistleblowing

Open a whistleblowing channel

whistleblowing_create_channel · Changes data · Markdown

Opens the channel where staff report concerns, anonymously if they like, read only by its named handlers.

$20.00 a call

From your agent’s balance. A call that fails costs nothing.

An example

We are 60 people now, so we need a whistleblowing channel. Mareike from compliance should handle the reports.

Your agent callswhistleblowing_create_channel$20.00 a call

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "name": "Hansen & Voss reports",
  "handlers": [
    "compliance@hansenvoss.example"
  ],
  "categories": [
    "Fraud or theft",
    "Safety",
    "Discrimination or harassment",
    "Data protection",
    "Something else"
  ]
}
What comes back
{
  "channel": {
    "name": "Hansen & Voss reports",
    "url": "https://cncto.co/r/hansen-voss",
    "handlers_url": "https://cncto.co/r/hansen-voss/handlers",
    "handlers": [
      "compliance@hansenvoss.example"
    ],
    "categories": [
      "Fraud or theft",
      "Safety"
    ],
    "intro": null,
    "external_info": "You can also report to the competent authority in your country. Reporting here first is not required.",
    "created_at": "2026-10-14T08:00:00+00:00"
  },
  "rent": {
    "rental_id": 4101,
    "kind": "whistleblowing",
    "label": "Whistleblowing: Hansen & Voss reports",
    "status": "active",
    "monthly_usd": "$20.00",
    "renews_at": "2026-11-14T08:00:00+00:00",
    "grace_until": null
  },
  "next": "Tell the staff where to report: link the channel's url from the intranet or the handbook."
}

Use it when

The business has 50 or more staff, or wants a safe way for people to raise concerns.

What it does

The channel every employer with 50 or more staff must run (EU Directive 2019/1937): a page where anyone reports a concern, anonymously if they like, and gets a case number and code to follow up. Only the named handlers read reports; you see their case numbers, dates and deadlines only. The handlers get an email now and whenever a report arrives. Only the owner can change the handlers later. $20.00 for the first month, then $20 a month from the balance.

What comes back

channel: its name, the page for reporters, the handlers' sign-in page, handlers, categories, intro and where else to report; rent: the monthly price and next renewal. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
nameRequiredstring1 to 120 characters.
handlersRequiredarray of stringsThe people who read and answer reports: impartial, named, 1 to 10. 1 to 10 items.
categoriesarray of stringsUp to 12 items.
introstringMarkdown above the form: what can be reported and how it is handled. Up to 20,000 characters.
external_infostringWhere else people may report: the competent authority. Up to 2,000 characters.

The call

Over MCP, call whistleblowing_create_channel on https://api.conecto.chat/mcp/whistleblowing. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/whistleblowing_create_channel \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Hansen & Voss reports","handlers":["compliance@hansenvoss.example"],"categories":["Fraud or theft","Safety","Discrimination or harassment","Data protection","Something else"]}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
conflict409The account has a channel already.Change it with whistleblowing_update_channel.
invalid_input400A handler is not an email address, or there are more than 10.Name 1 to 10 handlers by email.

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md