drift: audit vs current vendor docs (2026-04-16) — vendor sunset

[productdevbook]

Summary

Drift is being officially sunset by Clari + Salesloft (announced 2026-03-06, ~60-90 day customer wind-down) — wrapper should be marked deprecated and the live API gaps below largely become migration concerns.

Gaps found

Missing API surface

• drift.api.widget.show() / drift.api.widget.hide() — current show()/hide() call top-level drift.show()/drift.hide() (snippet methods), but the documented force-show/force-hide for both live chat and playbooks lives under drift.api.widget.* — https://devdocs.drift.com/docs/widget-start
• drift.api.toggleChat() — not exposed — https://devdocs.drift.com/docs/widget-start
• drift.api.goToConversation(conversationId) — not exposed; would let callers resume a known conversation — https://devdocs.drift.com/docs/widget-start
• drift.api.startInteraction({ interactionId, goToConversation, replaceActiveConversation }) — playbook fire-by-id; not exposed — https://devdocs.drift.com/docs/widget-start
• drift.api.setUserAttributes(attrs) — typed in our DriftAPI interface but never exported (code comment confirms); should be a public method or folded into identify for anonymous attribute updates — https://devdocs.drift.com/docs/using-drift-apis
• drift.page() — Drift's own SPA page-change snippet method; our pageView() calls drift.track("pageView") instead, losing path/locale and the documented SPA-tracking behavior — https://devdocs.drift.com/docs/installation

Events not bridged

• chatOpen / chatClose — https://devdocs.drift.com/docs/drift-events
• message / message:sent — no onMessage hook — https://devdocs.drift.com/docs/drift-events
• startConversation, conversation:selected, conversation:firstInteraction, conversation:playbookFired, conversation:playbookClicked, conversation:playbookDismissed, conversation:buttonClicked — https://devdocs.drift.com/docs/drift-events
• welcomeMessage:open / welcomeMessage:close, awayMessage:open / awayMessage:close, sliderMessage:close — https://devdocs.drift.com/docs/drift-events
• campaign:open / campaign:dismiss / campaign:click / campaign:submit — https://devdocs.drift.com/docs/drift-events
• scheduling:requestMeeting / scheduling:meetingBooked — https://devdocs.drift.com/docs/drift-events
• emailCapture / phoneCapture — useful for forwarding to identity store — https://devdocs.drift.com/docs/drift-events
• gdprClicked — https://devdocs.drift.com/docs/drift-events

Config options not exposed

• drift.config({ locale, enableWelcomeMessage, enableCampaigns, enableChatTargeting, backgroundColor, foregroundColor, autoAssignee, inboxId, cookieDomain, disableNewConversations, verticalOffset, horizontalOffset, messages: { welcomeMessage, awayMessage, thankYouMessage, emailCaptureMessage } }) — none of these are surfaced; in particular locale (we accept it on pageView and drop it) and cookieDomain matter for cross-subdomain identity — https://devdocs.drift.com/docs/widget-configuration

Deprecations in our current code

• pageView({ path, locale }) ignores both args and emits a generic track("pageView"); replace with drift.page(path) (or wire through drift.config({ locale })) — https://devdocs.drift.com/docs/installation
• Legacy driftt window alias is read in destroy() but never queried in load(); either drop it or use it as a fallback when window.drift is missing — https://devdocs.drift.com/docs/installation

Vendor product status

• Drift is being sunset. Clari + Salesloft announced the gradual sunset on 2026-03-06; existing customers have ~60–90 days before contract/access ends. Drift was taken offline in Sept 2025 after the Salesloft OAuth breach affecting 700+ orgs. Recommend marking ahize/drift as @deprecated in JSDoc, adding a console warn on load(), and skipping further API parity work in favor of a migration note. — https://www.salesloft.com/company/newsroom/salesloft-acquires-drift

Intentionally out of scope

• Agent-side / admin / Conversation API surfaces.
• Region/self-hosted endpoints (Drift docs list none beyond js.driftt.com).
• Building a 1mind successor adapter (separate work item if desired).

Sources

• https://devdocs.drift.com/docs/installation
• https://devdocs.drift.com/docs/widget-start
• https://devdocs.drift.com/docs/widget-configuration
• https://devdocs.drift.com/docs/drift-events
• https://devdocs.drift.com/docs/using-drift-apis
• https://www.salesloft.com/company/newsroom/salesloft-acquires-drift

[productdevbook]

Shipped a @deprecated JSDoc header + one-shot console.warn on load() in 837ec44 — keeps the wrapper functional while flagging vendor sunset to callers. Full API parity work tracked here remains open.