Featurebase Integration
Connect Featurebase, your customer feedback, bug-report, and changelog hub. A post flagged as a real problem then escalates straight into an Autoheal investigation. Agents can also read your Featurebase boards for context while they work.
The integration spans two Featurebase surfaces: the feedback boards (posts) and the support inbox (tickets and conversations). It has two halves, and you can use either or both of them:
- Alert source (webhook). When a post or ticket is created or updated, or a support conversation requests a handover, Featurebase sends a webhook to Autoheal. Autoheal turns that event into a single alert and can start an investigation from it. This is the "a real bug was filed / a customer needs help, go look into it" path.
- Data source (MCP tools). During any investigation, agents can use the Featurebase API to list and read posts and their comments. They can also read your changelog, and read support tickets, conversations, contacts and companies. This helps answer questions such as "has anyone else reported this?", "what shipped recently that could have caused this?" and "who is this customer and what did they say?".
Writes are opt-in and off by default. The read tools never modify anything. Agents can post an internal note on a support conversation, redact a note they posted, and write results back onto a ticket. Agents can do this only when you configure a Featurebase Admin ID (below). Leave that field blank to keep the integration read-only. Autoheal only ever writes internal, teammate-only notes. It is not a customer-facing correspondent, so it never posts a reply the customer can see. The Jira and Jira Service Management integrations take the same stance. Every note is attributed to the dedicated Autoheal teammate, never a human.
Capabilities
Once connected, agents can:
| Capability | Description |
|---|---|
| Escalate flagged posts | A post.created / post.updated webhook becomes one alert (deduplicated per post), which your alert-response rules can auto-investigate |
| Escalate tickets & handovers | A ticket.created / ticket.updated / conversation.handover_requested webhook becomes one alert (deduplicated per ticket number) |
| List posts | Search and filter posts by board, status, tags, review state, and free text, sorted and cursor-paginated — featurebase_list_posts |
| Read a post | Fetch a single post's full detail by id — featurebase_get_post |
| Read comments | Pull the comment thread on a post — featurebase_get_comments |
| Read changelogs | List live/draft changelog entries — featurebase_list_changelogs |
| List boards / statuses | Enumerate boards and post statuses with their ids — featurebase_list_boards, featurebase_list_statuses |
| Read a ticket | Fetch a support ticket by its ticket number — featurebase_get_ticket |
| List / read conversations | List support conversations, or read one with its full thread — featurebase_list_conversations, featurebase_get_conversation |
| Read contact / company | Resolve who reported an issue (by contact id) and which tenant they belong to (by the company's internal id, taken from the ticket or contact) — featurebase_get_contact, featurebase_get_company |
| List admins | Find the id of the Autoheal teammate for write attribution — featurebase_list_admins |
| Post internal note (opt-in) | Post a teammate-only internal note on a conversation (never customer-visible) — featurebase_post_conversation_note |
| Redact a note (opt-in) | Retract an internal note Autoheal posted in error — featurebase_redact_conversation_part |
| Update a ticket (opt-in) | Re-route, re-status, or backfill custom fields on a ticket — featurebase_update_ticket |
| Test connection | Check the API key and base URL — featurebase_test_connection |
At setup, the Featurebase Admin ID enables the write tools on this integration (post and redact internal notes, update tickets). The write tools are available to an agent unless its tool filters exclude them. A governance policy on write operations pauses each write for a person to approve. The Audit Trail records every call.
Agents read Featurebase through its API v2 (https://do.featurebase.app/v2), pinned to the date-versioned 2026-01-01.nova API. Board and status filters on featurebase_list_posts take ids, not names. Before they filter, agents use featurebase_list_boards / featurebase_list_statuses to resolve a name you mention (e.g. "the Bug board", "In Progress") to its id.
Prerequisites
- A Featurebase workspace on the Growth plan (or a Growth trial). The API, webhooks, and MCP access are Growth-plan features. On the Free plan, the Developers area is paywalled, and you cannot create an API key.
- An API key (Featurebase dashboard → Developers → API)
- For the webhook path: access to Featurebase Developers → Webhooks to create a webhook and copy its signing secret
Configuration Fields
| Field | Required | Description |
|---|---|---|
| API Key | Yes | Featurebase API key. Sent as the X-API-Key header on every read. Used by the data-source tools. |
| Webhook Signing Secret | No | The whsec_... secret Featurebase generates for your webhook. When set, Autoheal verifies every webhook's X-Webhook-Signature. Strongly recommended for the alert-source path. |
| Featurebase Admin ID | No | The Featurebase admin (teammate) id that Autoheal posts support-inbox internal notes as. Set it to enable the write tools. Leave it blank to keep the integration read-only. Autoheal only ever writes internal, teammate-only notes, never a customer-facing reply. Create a dedicated "Autoheal" teammate in Featurebase, then get its id from featurebase_list_admins. |
| API Base URL | No | Defaults to https://do.featurebase.app/v2. Only change it if Featurebase gives you a different API host. |
Setup
- Create an API key in Featurebase
In Featurebase, go to Developers → API and create an API key. Copy it. You will paste it into Autoheal. (The Developers area requires the Growth plan. If you don't see it, start a Growth trial.)
- Add the integration in Autoheal
- Go to Integrations in Autoheal and click Featurebase.
- Enter a name (e.g. "Production Featurebase").
- Paste the API Key.
- Configure the webhook (alert source)
- In Featurebase, go to Developers → Webhooks and create a webhook pointing at the webhook URL shown in Autoheal.
- Subscribe it to the post.created and post.updated events (feedback boards). If you use the support inbox, also subscribe to ticket.created, ticket.updated and conversation.handover_requested.
- Copy the webhook's signing secret (
whsec_...) and paste it into the Webhook Signing Secret field in Autoheal.
- (Optional) Enable support-inbox write-back
To let Autoheal post internal notes and update tickets:
- Create a dedicated Autoheal teammate in Featurebase.
- Run the
featurebase_list_adminstool to get its admin id. - Paste that id into the Featurebase Admin ID field.
Skip this step to keep the integration read-only. (Autoheal only ever writes internal, teammate-only notes. It never posts a customer-facing reply.)
- Test and save
Click Test Connection to check the API key. Then click Save. To check that the webhook reaches Autoheal, create or update a test post on a subscribed board.
How the alert-source flow works
- A post is created or updated on a Featurebase board you subscribed the webhook to.
- Featurebase sends a signed webhook to Autoheal.
- Autoheal verifies the signature, then normalizes the post into a single alert (
source_system = featurebase). Redeliveries and later updates of the same post collapse onto one alert. They do not create duplicate alerts. - Your alert-response rules decide whether to auto-investigate. You can scope this to a specific board (match on the
featurebase_board_idlabel). Then, for example, only your "Bug Reports" board escalates, and a "Feature Requests" board does not. - An agent investigates using the post's title, body, board, and author as context, alongside your other connected integrations (logs, metrics, code).
Featurebase has two terminal lifecycle types: Completed and Canceled. A "Rejected" status is a canceled-type status, so this covers it too. Autoheal ingests a post whose status has a terminal type as a resolved alert. This way, a webhook that fires on an already-handled post doesn't wake triage. Common terminal status names (Complete, Closed, Resolved, Done, Shipped, Rejected) resolve as well.
Tickets and handovers follow the same flow on the support-inbox surface. A ticket.created / ticket.updated / conversation.handover_requested webhook becomes one alert, deduplicated per ticket number. The ticket number equals the linked conversation id. The alert carries these labels for routing: featurebase_ticket_number, featurebase_conversation_id, featurebase_category, featurebase_company_id, and featurebase_customer_priority / featurebase_internal_priority. A terminal-status ticket resolves like a post. A handover request always fires, because it means that a customer is explicitly waiting on a human. When present, customer-set priority maps onto the alert severity.
Your Featurebase webhook subscription alone controls support-inbox ingest. Autoheal produces ticket/handover alerts only for the events you subscribe the webhook to. ticket.updated in particular fires on every status, assignee, or field change. On a busy inbox, this is far more volume than post.*. To scope or disable support-inbox ingest, unsubscribe the ticket.created / ticket.updated / conversation.handover_requested events in Featurebase (Developers → Webhooks). Or use an alert-response rule to narrow which of them start an investigation.
Support tickets and conversations contain customer-supplied text. Agents
treat those message bodies as untrusted data to investigate, never as
instructions. Autoheal never posts a customer-facing reply. It only writes
internal, teammate-only notes, so a human stays in the loop on anything the
customer sees. The opt-in featurebase_update_ticket tool can re-route or
re-status a ticket. Those changes are internal and reversible. But like any
write, they are reachable from injected text. Enable write-back only when you are
comfortable with that trade-off. Redaction is scoped to Autoheal's own internal
notes, so it can never remove a customer's message. When the write tools are
enabled, every internal note carries the Autoheal investigation link so the
thread has a clear audit trail.
To scope which posts escalate, use an alert-response rule that matches on the
featurebase_board_id label. For example, only auto-investigate posts on your
bug board. This is the reliable matcher. Every post carries its boardId, so
the rule always matches. Get the id from the board's settings in Featurebase or
from the featurebase_list_boards tool (it returns each board's id and name).
The featurebase_board label (the human board name) is only present when the
webhook payload expands the board object. Treat it as a best-effort fallback,
not the primary matcher.
Webhook Security
Featurebase signs each webhook with HMAC-SHA256 over "<timestamp>.<body>". It sends the result in the X-Webhook-Signature header and the timestamp in X-Webhook-Timestamp. When you configure a signing secret, Autoheal:
- rejects any delivery whose signature is missing or doesn't verify (constant-time compare).
- rejects a validly-signed but stale delivery (timestamp outside a 5-minute window), which blocks replay of a captured webhook.
If you leave the signing secret blank, Autoheal accepts unsigned deliveries. The URL secret is then the only guard. This is a documented trade-off. We strongly recommend that you configure the signing secret.
Example Queries
After you connect Featurebase, you can ask an agent questions like:
List open bug reports in Featurebase from the last week
Show me the comments on Featurebase post <id>
What changelog entries shipped in the last month?
Are there other Featurebase posts describing this same checkout error?
Troubleshooting
Test connection fails / 401 Unauthorized
- Check that the API key is correct and active. Copy it again from Developers → API. A partial paste or trailing whitespace is the most common cause.
- Check that your workspace is on the Growth plan. The API returns 401/403 for keys created before a plan lapsed.
- Check that the API Base URL is
https://do.featurebase.app/v2unless Featurebase gave you a different host.
Webhook not arriving
- Check that the webhook URL in Featurebase matches the URL shown in Autoheal.
- Check that the webhook is subscribed to post.created / post.updated.
- Create or update a post on a subscribed board to trigger a delivery.
Signature verification failed (401)
- Check that the Webhook Signing Secret matches the value Featurebase shows for the webhook. Check that you copied it without extra whitespace.
- If the secret is configured in Autoheal, Featurebase must send a signature. Autoheal rejects an unsigned delivery.
- A "stale timestamp" rejection means that the delivery's timestamp is more than 5 minutes off. Check that the sending system's clock is correct.
A post didn't start an investigation
- Ingestion and auto-investigation are separate. The post becomes an alert, but your alert-response rules decide whether to investigate. Check the rule's matchers. Use
featurebase_board_idto match a board (get the id fromfeaturebase_list_boards). Usefeaturebase_status/featurebase_status_typefor status. - Autoheal ingests posts in a terminal status (a Completed- or Canceled-type status, e.g. Complete/Closed/Resolved/Done/Shipped/Rejected) as resolved. These posts won't trigger triage.
Rate limited (429)
- The read tools honor Featurebase's
Retry-Afterand automatically slow their requests. Very large boards simply take longer to read page by page.