Skip to content

fix(source-intercom): bump heartbeat timeout from 6h to 9h#73635

Merged
agarctfi merged 3 commits intomasterfrom
devin/1771430309-bump-intercom-heartbeat-timeout
Feb 18, 2026
Merged

fix(source-intercom): bump heartbeat timeout from 6h to 9h#73635
agarctfi merged 3 commits intomasterfrom
devin/1771430309-bump-intercom-heartbeat-timeout

Conversation

@devin-ai-integration
Copy link
Contributor

@devin-ai-integration devin-ai-integration bot commented Feb 18, 2026

What

Increases the Intercom source heartbeat timeout (maxSecondsBetweenMessages) from 21,600s (6h) to 32,400s (9h) to prevent premature sync termination on the companies stream.

Related: airbytehq/oncall#11198 / #72955

The companies stream uses the Intercom scroll API with is_client_side_incremental: true. When the cursor is stale, the connector must scroll through all companies and filter client-side — going extended periods without emitting any RECORD or STATE messages. The platform heartbeat monitor only resets on RECORD and STATE, so the silent filtering period triggers a heartbeat timeout kill.

How

Two config changes in metadata.yaml:

  • maxSecondsBetweenMessages from 2160032400
  • dockerImageTag from 0.13.16-rc.10.13.17 (version bump via /bump-version)

Changelog entry auto-generated in docs/integrations/sources/intercom.md.

Review guide

  1. airbyte-integrations/connectors/source-intercom/metadata.yaml — timeout and version bump
  2. docs/integrations/sources/intercom.md — auto-generated changelog entry

Key items for reviewer:

  • This bumps the version from 0.13.16-rc.1 (RC) to 0.13.17 (GA). Confirm that shipping the timeout change as a GA release is intended.
  • This is a source-definition-level setting — it affects all Intercom connections, not just the one experiencing the issue. Is 9h of tolerated silence acceptable across the board?
  • This is a band-aid. The root fix would be either a CDK change (emit heartbeat-resetting messages during client-side filtering) or a platform change (allow LOG messages to reset the heartbeat). Neither is in scope here.
  • 9h was chosen as 1.5× the current 6h value. If the companies dataset is very large, this may still not be enough.

User Impact

Intercom syncs with stale companies cursors will no longer be killed prematurely by the heartbeat monitor. No impact on syncs that are already completing within 6h.

Can this PR be safely reverted and rolled back?

  • YES 💚

Link to Devin run: https://app.devin.ai/sessions/77cf265ee5f1499988257947bf79b923
Requested by: @agarctfi

…6h to 9h)

The companies stream uses the Intercom scroll API with client-side incremental
filtering. When the cursor is stale, the connector spends extended periods
fetching and filtering records without emitting any RECORD or STATE messages,
triggering the platform heartbeat timeout.

Only STATE and RECORD messages reset the platform heartbeat timer, so the
silent filtering period causes the sync to be killed.

Increasing from 6 hours to 9 hours provides sufficient headroom for the
companies scroll to complete.

Co-Authored-By: alfredo.garcia@airbyte.io <freddy.garcia7.fg@gmail.com>
@devin-ai-integration
Copy link
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@octavia-bot octavia-bot bot marked this pull request as draft February 18, 2026 16:00
@octavia-bot
Copy link
Contributor

octavia-bot bot commented Feb 18, 2026

Note

📝 PR Converted to Draft

More info...

Thank you for creating this PR. As a policy to protect our engineers' time, Airbyte requires all PRs to be created first in draft status. Your PR has been automatically converted to draft status in respect for this policy.

As soon as your PR is ready for formal review, you can proceed to convert the PR to "ready for review" status by clicking the "Ready for review" button at the bottom of the PR page.

To skip draft status in future PRs, please include [ready] in your PR title or add the skip-draft-status label when creating your PR.

@github-actions
Copy link
Contributor

👋 Greetings, Airbyte Team Member!

Here are some helpful tips and reminders for your convenience.

💡 Show Tips and Tricks

PR Slash Commands

Airbyte Maintainers (that's you!) can execute the following slash commands on your PR:

  • 🛠️ Quick Fixes
    • /format-fix - Fixes most formatting issues.
    • /bump-version - Bumps connector versions, scraping changelog description from the PR title.
  • ❇️ AI Testing and Review:
    • /ai-docs-review - Provides AI-powered documentation recommendations for PRs with connector changes.
    • /ai-prove-fix - Runs prerelease readiness checks, including testing against customer connections.
    • /ai-canary-prerelease - Rolls out prerelease to 5-10 connections for canary testing.
    • /ai-review - AI-powered PR review for connector safety and quality gates.
  • 🚀 Connector Releases:
    • /publish-connectors-prerelease - Publishes pre-release connector builds (tagged as {version}-preview.{git-sha}) for all modified connectors in the PR.
    • /bump-progressive-rollout-version - Bumps connector version with an RC suffix (2.16.10-rc.1) for progressive rollouts (enableProgressiveRollout: true).
      • Example: /bump-progressive-rollout-version changelog="Add new feature for progressive rollout"
  • ☕️ JVM connectors:
    • /update-connector-cdk-version connector=<CONNECTOR_NAME> - Updates the specified connector to the latest CDK version.
      Example: /update-connector-cdk-version connector=destination-bigquery
    • /bump-bulk-cdk-version bump=patch changelog='foo' - Bump the Bulk CDK's version. bump can be major/minor/patch.
  • 🐍 Python connectors:
    • /poe connector source-example lock - Run the Poe lock task on the source-example connector, committing the results back to the branch.
    • /poe source example lock - Alias for /poe connector source-example lock.
    • /poe source example use-cdk-branch my/branch - Pin the source-example CDK reference to the branch name specified.
    • /poe source example use-cdk-latest - Update the source-example CDK dependency to the latest available version.
  • ⚙️ Admin commands:
    • /force-merge reason="<REASON>" - Force merges the PR using admin privileges, bypassing CI checks. Requires a reason.
      Example: /force-merge reason="CI is flaky, tests pass locally"
📚 Show Repo Guidance

Helpful Resources

📝 Edit this welcome message.

@agarctfi agarctfi changed the title source-intercom: bump heartbeat timeout from 6h to 9h fix(source-intercom): bump heartbeat timeout from 6h to 9h Feb 18, 2026
Copy link
Contributor Author

@devin-ai-integration devin-ai-integration bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 1 additional finding.

Open in Devin Review

@agarctfi
Copy link
Contributor

agarctfi commented Feb 18, 2026

/bump-version

Bump Version job started... Check job output.

✅ Changes applied successfully. (ae9e92e)

@github-actions
Copy link
Contributor

github-actions bot commented Feb 18, 2026

source-intercom Connector Test Results

13 tests   9 ✅  13s ⏱️
 2 suites  4 💤
 2 files    0 ❌

Results for commit af91c2f.

♻️ This comment has been updated with latest results.

@github-actions
Copy link
Contributor

github-actions bot commented Feb 18, 2026

Deploy preview for airbyte-docs ready!

✅ Preview
https://airbyte-docs-ee8g8u2r2-airbyte-growth.vercel.app

Built with commit af91c2f.
This pull request is being automatically deployed with vercel-action

@agarctfi agarctfi marked this pull request as ready for review February 18, 2026 16:33
@agarctfi agarctfi merged commit f49a46d into master Feb 18, 2026
52 checks passed
@agarctfi agarctfi deleted the devin/1771430309-bump-intercom-heartbeat-timeout branch February 18, 2026 16:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

Comments