# Smsmode

## Creating the smsmode Configuration

This section details the necessary steps to link the smsmode platform to the Dydu solution, enabling communication via SMS. The procedure requires actions on both interfaces: Dydu (Channels) and smsmode (Configuration).

### Retrieving the Dydu Endpoint

1. Access the **Dydu** interface, then navigate to **Integration > Channels**.

<figure><img src="https://264031769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPMvi3Izk7dvjl9HitZpp%2Fuploads%2Fih629w2z1lfvrwLUj1qz%2Fimage.png?alt=media&#x26;token=5952dbe2-ca80-4874-a167-ab487c23e42e" alt="" width="563"><figcaption></figcaption></figure>

2. Click on **smsmode** and assign a title to this new configuration.

<figure><img src="https://264031769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPMvi3Izk7dvjl9HitZpp%2Fuploads%2FDiU1zJNLfyF3oGQcnJ9x%2Fimage.png?alt=media&#x26;token=fa5344fd-01e5-4ac3-9be7-9718a87f1197" alt="" width="563"><figcaption></figcaption></figure>

3. Click on "**Create"**
4. Copy the generated **Endpoint URL** and **keep it aside temporarily**.
5. Select the language and the knowledge space (consultation space) associated with the chatbot.

<figure><img src="https://264031769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPMvi3Izk7dvjl9HitZpp%2Fuploads%2FLKW9LCbYkMNgT177bGsY%2FCapture%20d%E2%80%99%C3%A9cran%20du%202025-12-16%2010-48-32.png?alt=media&#x26;token=7c327d28-19cb-4fc3-8fcf-4f7f1b1d7324" alt=""><figcaption></figcaption></figure>

### Webhook Configuration on the smsmode Interface

The retrieved endpoint must be configured in smsmode to receive incoming messages (MOs).

1. Go to the configuration **interface of the smsmode website**.
2. Access your **configuration** section.
3. Navigate to **Settings > Webhooks**.

<figure><img src="https://264031769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPMvi3Izk7dvjl9HitZpp%2Fuploads%2FPAEsVFN2XSmqFlHy8l7y%2Fimage.png?alt=media&#x26;token=6bc9a2ce-42f3-4808-a71d-a24a4df77d84" alt="" width="176"><figcaption></figcaption></figure>

4. Paste the **endpoint** copied in previous step into the "**URL for MO notifications**" field.

<figure><img src="https://264031769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPMvi3Izk7dvjl9HitZpp%2Fuploads%2FwL6NJGgNCrXbNYJAYpy0%2Fimage.png?alt=media&#x26;token=f4c3a66e-ab9d-453b-b255-520a0070cddc" alt="" width="563"><figcaption></figcaption></figure>

5. Validate the modification by clicking on "**Edit**".

### Generating the smsmode API Key

1. In the smsmode interface, navigate to **Settings > API Keys**.

<figure><img src="https://264031769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPMvi3Izk7dvjl9HitZpp%2Fuploads%2FMq5t1cjEWP0b2mwfrMDd%2Fimage.png?alt=media&#x26;token=dbe89f1d-816b-4e3f-a178-34ceff34172d" alt="" width="178"><figcaption></figcaption></figure>

2. Click on "**Generate a new API key**".

<figure><img src="https://264031769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPMvi3Izk7dvjl9HitZpp%2Fuploads%2FM1gC6ycIy3gIDeD5I06c%2Fimage.png?alt=media&#x26;token=6c44249d-cdfc-4f15-8ff0-987a69238dde" alt="" width="563"><figcaption></figcaption></figure>

3. Assign a **name** to this new API key and click on "**Create**".

<figure><img src="https://264031769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPMvi3Izk7dvjl9HitZpp%2Fuploads%2FN2MfSi9js3urTfIs6zej%2Fimage.png?alt=media&#x26;token=ba5a7eb5-1ad8-467d-b52a-4b1710af9b9c" alt="" width="319"><figcaption></figcaption></figure>

4. **Copy the generated API key** and **save it securely** (for security reasons, it will no longer be accessible or displayed afterward).

<figure><img src="https://264031769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPMvi3Izk7dvjl9HitZpp%2Fuploads%2FxttU11dmJT3A8AyHF91U%2Fimage.png?alt=media&#x26;token=934b9c3c-3c92-4c7e-907e-ebb9c2d6c5d8" alt="" width="479"><figcaption></figcaption></figure>

### Finalization and Dydu Connection

1. Return to the **smsmode** integration on the **Dydu Channels** interface.
2. Paste the **API key** retrieved in previous step into the dedicated field "**smsmode API Key**".

<figure><img src="https://264031769-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPMvi3Izk7dvjl9HitZpp%2Fuploads%2Fo02rRqBLQpp1Tisugolj%2Fimage.png?alt=media&#x26;token=cee436b9-6d40-4409-a28a-db5cfb80a3a2" alt="" width="563"><figcaption></figcaption></figure>

3. Click on **Finish** to save and activate the configuration.

The Dydu chatbot is now connected to the smsmode number. You can validate the integration by sending a test message to this number.