Inbox and channels · how to

Connect and validate WhatsApp

Choose the correct Meta connection mode, add a company-owned WhatsApp sender, route it, and prove inbound and outbound behavior.

5 min readUpdated August 17, 2026
For
Owner, Admin, Member
Availability
Your current plan and entitlements
Product evidence
WRKZY · reviewed August 17, 2026
Editorial review
WRKZY Editorial
Before you begin
  • Owner/Admin approval for the intended WRKZY workspace
  • Administrator access to the Meta business that owns the number
  • A supported existing Business App number or a new/unused Cloud API sender
  • A destination team inbox and approved test recipient

Choose the connection mode first

Open Settings → WhatsApp → Add WhatsApp sender. WRKZY offers two Meta Embedded Signup paths:

  • Connect Business App: choose supported business-app coexistence when the business needs to keep using the WhatsApp Business App while WRKZY syncs supported activity.
  • Connect Cloud API: choose a new or unused sender for WhatsApp Cloud API without existing Business App continuity.

Choosing the wrong path can disrupt the operating assumption for the number. Confirm how the business uses it today before starting Meta authorization.

Meta remains the authority for account eligibility and acceptable business messaging. Review the current WhatsApp Business Messaging Policy before connecting a production sender or changing how it is used.

Prepare the business and routing decision

  1. Confirm the WRKZY workspace URL.
  2. Confirm the Meta business and WhatsApp Business Account that own the number.
  3. Identify the person authorized to approve Meta Embedded Signup.
  4. Decide whether this will be the default outbound sender when several numbers are connected.
  5. Choose the destination team inbox and the member group responsible for inbound work.
  6. Record the current number usage and a rollback contact.
  7. Prepare an approved external test number that can both send and receive.

Complete Meta Embedded Signup

  1. Select the mode that matches the number.
  2. Choose Connect Business App or Connect Cloud API.
  3. Complete Meta's business, account, and phone-number selections.
  4. Confirm the connection inside Meta when prompted.
  5. Return to WRKZY and wait for the sender to appear in WhatsApp senders.
  6. Open sender details and verify the displayed name/identifier, connection type, and status.
  7. When more than one sender exists, select Set default only after confirming which identity should route ordinary outbound messages.

Meta Embedded Signup requires HTTPS. Local HTTP setup can show a message directing administrators to a deployed URL or HTTPS tunnel.

Read connection and sync state

States and meaning
StateMeaning
ConnectedThe sender is available to WRKZY; continue with routing and message tests
History sync requestedWRKZY has asked Meta for supported history
Syncing historySupported history processing is active
History syncedThe requested supported history completed
DisconnectedProvider authorization or connection is no longer usable
Connected with sync warningNew messaging may still work even if historical synchronization needs review

History synchronization and new-message transport are related but not identical. A sync warning does not automatically prove inbound or outbound messaging is down.

Route the sender to Work

  1. Open Settings → Messaging → Team inboxes.
  2. Select the responsibility-owned inbox.
  3. Attach or route the connected WhatsApp sender.
  4. Confirm members, default/fallback routing, and any separate SLA or policy.
  5. Review the channel count and explicit-route summary.
WRKZY team inbox configuration with routing and membership controlsOpen full size
Team inbox settings make the connected channel, default route, unassigned work, and responsibility boundary visible.

Validate the customer path

WhatsApp validation path

  1. 01
    GateCustomer permission

    Confirm consent and recipient eligibility for the intended message.

  2. 02
    IdentityApproved sender

    Use the connected business identity and its provider rules.

  3. 03
    DecisionSession or template

    Choose content allowed for the current conversation window.

  4. 04
    EvidenceProvider delivery

    Submitted is not delivered; read the provider-backed state.

  5. 05
    OutcomeReply and follow-through

    Route the response or exception to an accountable owner.

Meta authorization connects the sender; team-inbox routing receives the conversation; assignment and delivery evidence prove operation.
  1. From the approved external test number, send a unique harmless message to the connected business number.
  2. Confirm a conversation appears in Inbox → Work under the expected team inbox and WhatsApp channel label.
  3. Verify the customer/test contact and connected sender identity.
  4. Assign the conversation.
  5. Send a reply that complies with the current WhatsApp conversation/template requirements shown by the product.
  6. Confirm the message changes from Sending to Sent and then any provider-reported Delivered/Read state.
  7. Verify the reply arrives on the external device.

If validation fails

  • Embedded Signup unavailable: preserve the exact visible message and contact WRKZY Support. Do not enter provider data in a workaround form or share Meta credentials.
  • Meta returns no account or phone ID: restart only after the business owner confirms the correct WABA and registered number.
  • Connected, no inbound message: verify the exact number, Meta callback subscription, sender status, and team-inbox route.
  • Inbound works, outbound fails: verify default sender, recipient eligibility/restriction, allowed message type/template, and the visible error.
  • Wrong team inbox: correct the channel route; do not rely on permanent manual reassignment.
  • History sync failed: test new inbound/outbound separately, then recover the sync problem without removing a working sender.
  • First reply is unclear: inspect message state before retrying to avoid duplicates.

Removing a number is consequential. It can stop future use in WRKZY; resolve exact target and continuity before confirming removal.

Measurable readiness

Track percentage of inbound tests routed correctly, unassigned WhatsApp work, send failures by reason, and time from provider failure to recovery. “Connected” is a setup milestone; correctly routed and verified customer communication is the outcome.

WhatsApp acceptance check
  • Connection mode matches current number use
  • Company-owned Meta authorization used
  • Correct sender and default confirmed
  • Team-inbox route verified
  • Inbound test received
  • Outbound test delivered to approved recipient
  • Provider state reviewed
  • No credentials captured
Was this guide useful?

Choose an answer. No message text or personal information is collected.

Still need help?

Contact WRKZY support with the workspace name and a safe, redacted example.

Contact support about this guide