# SMS & Voice Direct onboarding flow

**Manual onboarding**

**1.** Create a new SMS-DIRECT 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.** Symphony Connect Helper creates a room with the contact.

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

**4.** The contact has an SMS conversation on their phone. You can continue the flow as usual.

{% hint style="info" %}
Symphony users sending a SMS message to a US-based contact for the first time will trigger an opt in/opt out step, in line with the requirements laid out in the Telephone Consumer Protection Act of 1991 (“TCPA”). The contact cannot receive the first message sent by the Symphony user until they explicitly opt in to communicate via the channel.
{% endhint %}

<figure><img src="/files/8pPT2HHO9Q0k97l6FrgT" alt=""><figcaption><p><em>Manual SMS &#x26; Voice Direct onboarding</em></p></figcaption></figure>

**'On-the-fly' onboarding (inbound message)**

**1.** A Symphony user receives an unsolicited SMS or phone call from a phone number (an SMS-DIRECT number) that is not associated with any existing contact in their list.

**2.** A new incomplete contact is created ‘on-the-fly’ in the contact list.

In the SMS & Voice Direct extension app (Symphony Desktop), the contact’s card shows an *INCOMPLETE* status and only displays the phone number. The contact's name and details can be edited afterwards.

**3.** Symphony Connect Helper creates a room with the contact.

**4.** Symphony Connect Helper sends a welcome message to the contact. You can continue the flow as usual.

<figure><img src="/files/vdzkMiuZkpKnx4TW3JHo" alt=""><figcaption><p><em>On-the-fly SMS &#x26; Voice Direct onboarding</em></p></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-1.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.