# WhatsApp onboarding flow

**1.** Create a new WhatsApp contact (use the [Add a contact and/or advisors to a contact](/26.06/readme/contact.md#add-a-contact-and-or-advisors-to-a-contact) API).

**2.** Create a room (use the [Create room](/26.06/readme/room.md#create-room) API).

**3.** Add the new contact to the room (use the [Add room member ](/26.06/readme/room.md#add-room-member)API).

**4.** Symphony Connect Helper sends the welcome message template to the new contact.

**5.** Check whether:

* The message *"We couldn’t add to this room as their WhatsApp account was not found"* is sent in the room.\
  OR
* In the WhatsApp Connect app, the contact’s card shows the status *UNAVAILABLE* (if using a bot, check for `"status": "UNAVAILABLE"` in the API response).

**6.** If the contact’s status is *UNAVAILABLE*:

* The contact does not have the WhatsApp app, and you should remove them.

{% hint style="info" %}
If they're the last contact in the room, this will deactivate the room.
{% endhint %}

* Ask the user to create a WhatsApp account or provide their correct phone number and retry the onboarding.

**7.** If the contact’s status is **different from** *UNAVAILABLE* (see the [Contact status](/26.06/readme/contact/contact-status.md) section):

* The contact has the WhatsApp app, and you can continue the flow as usual.

{% hint style="warning" %}
No status will be returned if the contact is created without being added to a room.
{% endhint %}

<figure><img src="/files/U2OgDJEY31FDn7APuBZA" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://rest-api-federation.symphony.com/26.06/readme/getting-started/whatsapp-onboarding-flow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.