> For the complete documentation index, see [llms.txt](https://docs.ngsurvey.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ngsurvey.com/installation-setup/installation/whatsapp-messenging/twilio-whatsapp.md).

# Twilio

Connect to WhatsApp using Twilio

Using [Twilo ](https://www.twilio.com)you can enable ngSurvey to interact with WhatsApp respondents as such if you would like to use the [WhatsApp conversational surveys](/conversational-surveys.md) features it is mandatory to have a registered Twilio account along a Facebook Business Manager account.

## Main setup

To register for a Twilio account and setup it with WhatsApp please follow the official [Twilio / WhatsApp setup ](https://www.twilio.com/docs/whatsapp/tutorial/connect-number-business-profile) documentation.

## Callback URL

Once you have setup your Twilio account with WhatsApp you need to link ngSurvey and Twilio using a callback URL. 

1\) Find your ngSurvey callback URL in your account / [system settings](/installation-setup/system-settings.md) page.

![](https://1025048312-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M8fLhS0bmfBRyq0HdUm%2F-MJGFGBgaDzxGzFpnnuv%2F-MJGG2RBphWf_IiWLFgI%2Fimage.png?alt=media\&token=4fdb1ef2-4381-4f2a-93ad-b36f1455a336)

2\) Copy this URL 

3\) Open the Twilio [WhatsApp Senders user interface](https://www.twilio.com/console/sms/whatsapp/senders) 

4\) Click on the Configure button on the WhatsApp number that you will use in ngSurvey

5\) Paste the callback URL that you have copied on step 2.

![](https://1025048312-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M8fLhS0bmfBRyq0HdUm%2F-MJGJSuqMU6sI7b4S_fH%2F-MJGKAVPHS4V8Jnn4i4Q%2Fimage.png?alt=media\&token=dae736d4-2ce6-4e2b-b811-e0f95fb453d2)

6\) Click Configure. That's it! From now on Twilio will notify your ngSurvey server on each new WhatsApps messages.

## NGSurvey setup

Once you have setup Twilio the last step is to save your Twilio account settings in your ngSurvey account or [system settings](/installation-setup/system-settings/mobile-messenging/twilio.md) page, once this is done you will be ready to use your Twilio WhatsApp enabled number to start conversation with your customers.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ngsurvey.com/installation-setup/installation/whatsapp-messenging/twilio-whatsapp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.