WOS

Core Platform – Authentication – Abandoned registration recovery (Intercom + Firebase)

J
João NevesinWOS
8 months ago

Goal
Recover users who start registration, provide their email, but never complete the phone verification step.


Problem today

  • Firebase gets the user email early in the flow

  • Intercom only gets user data later, after visiting Profile

  • Users who stop before phone verification are invisible to CRM

  • No recovery email is sent


New logic

Trigger point

As soon as the user completes:

  • Email + password step, or

  • Google/Gmail auth step

and we already have:

  • email

  • uid or temp registration id

we should immediately send that user data to Intercom.


Recovery condition

If no phone number is added within 2 hours after registration started:

  • trigger an automated Intercom email

  • objective:

    • offer help

    • remind them to finish registration

    • incentivize completion


Required flow

1. Early Intercom sync

At the moment the email is captured:

  • create/update Intercom lead/contact

  • send:

    • email

    • Firebase UID

    • registration source

    • registration_started_at

    • auth method (email_password or google)

    • phone_verified = false

This should happen before profile completion.


2. Track phone verification state

When the phone step is completed:

  • update Intercom user/contact

  • set:

    • phone_verified = true

    • registration_completed = true or equivalent


3. Delayed CRM automation

If after 2 hours:

  • phone_verified = false

send Intercom email.


Intercom email intent

The message should:

  • remind the user they are one step away

  • explain why phone verification is needed

  • offer support if they had problems

  • include direct CTA to resume registration

Example themes:

  • “You’re almost there”

  • “Need help finishing your account?”

  • “Complete your registration to access Betarena”


Suggested Intercom attributes

  • firebase_uid

  • auth_method

  • registration_started_at

  • phone_verified

  • registration_completed

  • registration_abandoned

  • registration_resume_url


Resume logic

The email should include a resume registration link that takes the user directly back to the phone verification step.

If possible:

  • restore session

  • redirect straight into verification flow


Technical approach

On registration start

Backend/frontend sends user to Intercom immediately:

  • via Intercom API

  • or via backend event

Delay handling

Best approach:

  • schedule a check at started_at + 2h

  • if phone_verified = false, mark:

    • registration_abandoned = true

  • Intercom campaign sends email based on that condition

Alternative:

  • let your backend trigger the email directly through Intercom after the delay


Edge cases

  • User finishes registration before 2 hours → no email

  • User verifies phone after email is sent → stop follow-ups

  • Google auth users without completed phone step should follow same logic

  • Avoid duplicates if user retries registration multiple times


Dev steps

  1. Move Intercom sync to the email capture/auth step

  2. Add user attributes for registration progress

  3. Track phone verification completion

  4. Create delayed check after 2 hours

  5. Add Intercom automation email

  6. Add resume-registration deep link

  7. QA duplicate prevention and state transitions

Outcome: Betarena captures abandoned registrations much earlier and can automatically recover users who drop off before phone verification.

  1. In Review
  2. Planned
  3. In Progress
  4. Completed
Loading content, please wait...
Loading content, please wait...
Loading content, please wait...
Loading content, please wait...
Loading content, please wait...
Loading content, please wait...
Loading content, please wait...
Loading content, please wait...
Loading content, please wait...
Loading content, please wait...
Loading content, please wait...
Loading content, please wait...