Skip to main content
hyzl can only call or text a member who left if there is a phone number on their billing record. This page shows where that number has to live for each provider. It also shows how to add it and how to check your coverage.
Phone contact should be something your members opt into. Collect that consent explicitly. A separate, unchecked checkbox at signup works well. Use clear language like “I agree to receive phone calls from [Your Company] about my account, including AI-assisted calls.” Store the consent on your own records, together with the wording they agreed to. Give people a way to opt out.

​
Where the number has to be

When a member cancels or a payment fails, hyzl reads their phone number from one specific place per provider: hyzl does not use a number kept anywhere else. That includes a charge, an invoice, metadata, and a custom RevenueCat attribute. It normalizes numbers to E.164, and it skips anything that cannot be normalized.

​
Stripe

hyzl reads the Phone field on the Stripe Customer. Three ways to get it there:
  • New members (automatic). Turn on phone number collection for Checkout or Payment Links. Stripe then saves the number onto the Customer for you.
  • One member. Open their Customer in Stripe, choose Edit, and fill in the Phone field.
  • In bulk. Set customer.phone in E.164 format (for example +15551234567) through the Stripe API.

​
RevenueCat

hyzl reads the reserved $phoneNumber subscriber attribute. Other custom attributes are not used.
  • In your app. Set $phoneNumber as soon as you have the number, after a one-time password step or at signup. Use the setPhoneNumber helper in the RevenueCat software development kit.
  • Existing members. Set the $phoneNumber attribute through the RevenueCat subscriber attributes API.
  • Format. Use E.164 (for example +15551234567). Free-text numbers are normalized where possible and skipped when they cannot be.
$phoneNumber is a reserved RevenueCat attribute, not a custom one you create. Set it with the reserved setPhoneNumber helper (or the reserved $phoneNumber key) so it lands in the right place.

​
Check your coverage

Two places in the portal show how many of your members are reachable:
  • On the main Dashboard, See where you're losing people shows a Who we can chase figure. That is the share of people who left that have a phone we can call or text.
  • On the Integrations page, the connected Stripe card shows your overall phone coverage.
When coverage is low, the dashboard’s Add phones button opens the same Stripe and RevenueCat steps shown above.

​
Backfill existing members

Most of your past members may have signed up before you collected phone numbers. You do not have to do it by hand. Reach out from the in-app chat. You can also email support@atllas.com directly. We will help you backfill numbers from your own data, or set up collection going forward.