Lesson 4 of 7 · 4 min

Choosing a Service Provider

Select which media company will fulfill your order from the providers you are linked to.

Choosing a Service Provider

Video coming soon

4/7

Lesson Notes

01

The Provider step shows you the list of media companies — also called provider organizations — that your account is connected to as a customer. Each row displays the company's name, logo avatar, and city or region so you can distinguish providers at a glance if you work with more than one. Tapping a row selects it, highlighted with a brand-colored border and a checkmark, and enables the Continue button in the footer. Selecting a different provider clears any previously picked package so you start fresh with that provider's catalogue.

02

For most agents who work with a single company, this step is quick: one provider is listed and you tap it. If your company uses a whitelabel customer portal — a branded version of Vremly built on top of a single provider's workspace — the Provider step may be skipped entirely because the provider is implicit. In that case, the booking flow jumps straight to the Package step and the provider is resolved behind the scenes from the portal's locked organization ID.

03

On the web, the AgentBookingFlow renders a ProviderStep component that fetches your linked provider organizations via /me/customer-organizations. The list is loaded once per session and cached for the booking flow's lifetime. If the list is empty, the step shows an empty state: 'You are not linked as a customer to any provider yet.' Contact the media company and ask them to add you as a customer in their Vremly workspace — they control that connection.

04

On iOS, the provider picker inside BookingView shows the same org list. Each row uses a VAvatar component (shows the provider's logo or initials) alongside the org name and city. The selection state is stored in the BookingModel's `selectedProvider` property. If the tenant is a customer-portal build (Tenant.current.isCustomerPortal with a lockedOrgId), or if your active workspace is a non-personal company workspace, the entire provider step is removed from the visible breadcrumb steps and the provider is resolved automatically via resolveImplicitProviderIfNeeded.

05

After choosing a provider, Vremly loads that provider's package catalogue and add-on list in the background while you are on this step — so by the time you reach the Package step, the data is ready. If you go back to the Provider step and pick a different provider, the package list is cleared and reloaded for the new selection.

Key Takeaways

  • The Provider step shows only companies you are linked to as a customer — contact the provider to be added if missing.
  • Switching providers clears any previously selected package.
  • Customer portal users and company workspace users skip this step — the provider is implicit.
  • On iOS, the provider list is hidden from the breadcrumb if the tenant is locked to a single provider.
Related documentation at docs.vremly.com