Muhsin Keloth
3e5b2979eb
feat: Add support for sending CSAT surveys via templates (Whatsapp Cloud) (#12787)
This PR enables sending CSAT surveys on WhatsApp using approved WhatsApp
message templates, ensuring survey delivery even after the 24-hour
session window.
The system now automatically creates, updates, and monitors WhatsApp
CSAT templates without manual intervention.
<img width="1664" height="1792" alt="approved"
src="https://github.com/user-attachments/assets/c6efd61e-1d01-4738-abb6-0afc0dace975"
/>
#### Why this change
Previously, WhatsApp CSAT messages failed outside the 24-hour customer
window.
With this update:
- CSAT surveys are delivered reliably using WhatsApp templates
- Template creation happens automatically in the background
- Users can modify survey content and recreate templates easily
- Clear UI states show template approval status
#### Screens & States
<details>
<summary>Default — No template configured yet</summary>
<img width="1662" height="1788" alt="default"
src="https://github.com/user-attachments/assets/ed26d71b-cf7c-4a26-a2af-da88772c847c"
/>
</details>
<details>
<summary>Pending — Template submitted, awaiting Meta approval</summary>
<img width="1658" height="1816" alt="pending"
src="https://github.com/user-attachments/assets/923b789b-d91b-4364-905d-e56a2b65331a"
/>
</details>
<details>
<summary>Approved — Survey will be sent when conversation
resolves</summary>
<img width="1664" height="1792" alt="approved"
src="https://github.com/user-attachments/assets/c6efd61e-1d01-4738-abb6-0afc0dace975"
/>
</details>
<details>
<summary>Rejected — Template rejected by Meta</summary>
<img width="1672" height="1776" alt="rejected"
src="https://github.com/user-attachments/assets/f69a9b0e-be27-4e67-a993-7b8149502c4f"
/>
</details>
<details>
<summary>Not Found — Template missing in Meta Platform</summary>
<img width="1660" height="1784" alt="not-exist"
src="https://github.com/user-attachments/assets/a2a4b4f7-b01a-4424-8fcb-3ed84256e057"
/>
</details>
<details>
<summary>Edit Template — Delete & recreate template on change</summary>
<img width="2342" height="1778" alt="edit-survey"
src="https://github.com/user-attachments/assets/0f999285-0341-4226-84e9-31f0c6446924"
/>
</details>
#### Test Cases
**1. First-time CSAT setup on WhatsApp inbox**
- Enable CSAT
- Enter message + button text
- Save
- Expected: Template created automatically, UI shows pending state
**2. CSAT toggle without changing text**
- Existing approved template
- Toggle CSAT OFF → ON (no text change)
- Expected: No confirmation alert, no template recreation
**3. Editing only survey rules**
- Modify labels or rule conditions only
- Expected: No confirmation alert, template remains unchanged
**4. Template text change**
- Change survey message or button text
- Save
- Expected:
- Confirmation dialog shown
- On confirm → previous template deleted, new one created
- On cancel → revert to previous values
**5. Language change**
- Change template language (e.g., en → es)
- Expected: Confirmation dialog + new template on confirm
**6. Sending survey**
- Template approved → always send template
- Template pending → send free-form within 24 hours only
- Template rejected/missing → fallback to free-form (if within window)
- Outside 24 hours & no approved template → activity log only
**7. Non-WhatsApp inbox**
- Enable CSAT for email/web inbox
- Expected: No template logic triggered
Fixes
https://linear.app/chatwoot/issue/CW-6188/support-for-sending-csat-surveys-via-approved-whatsapp
---------
Co-authored-by: Sivin Varghese <64252451+iamsivin@users.noreply.github.com>
Co-authored-by: Vinay Keerthi <11478411+stonecharioteer@users.noreply.github.com>
Co-authored-by: iamsivin <iamsivin@gmail.com>
2026-01-06 11:46:00 +04:00
..
2025-10-06 09:05:54 -07:00
2025-12-19 12:41:33 -08:00
2025-12-08 10:52:17 +05:30
2025-07-30 10:52:47 -07:00
2025-11-18 18:20:58 -08:00
2025-11-21 16:31:45 -08:00
2025-12-17 07:54:50 -08:00
2024-06-03 15:54:19 +05:30
2021-10-13 18:35:13 +05:30
2025-05-29 14:42:13 +05:30
2025-09-12 16:22:42 +05:30
2024-02-16 17:01:27 +05:30
2023-09-27 14:02:34 +05:30
2022-05-23 19:24:07 +05:30
2025-09-10 12:07:21 +05:30
2021-11-11 15:23:33 +05:30
2023-04-17 19:11:05 +05:30
2025-06-11 19:05:30 -04:00
2023-08-31 10:36:02 +07:00
2022-06-03 11:12:22 +05:30
2023-07-14 13:35:30 +05:30
2021-05-04 15:08:41 +05:30
2020-03-09 23:27:10 +05:30
2025-10-27 14:39:49 +05:30
2020-03-28 11:43:02 +05:30
2025-11-18 15:29:15 +05:30
2021-10-25 18:35:58 +05:30
2025-11-24 17:47:00 -08:00
2020-03-09 23:27:10 +05:30
2023-05-23 16:47:04 +05:30
2024-09-17 11:40:11 -07:00
2022-01-24 17:37:43 +05:30
2022-06-01 11:13:10 +05:30
2025-06-11 19:05:30 -04:00
2026-01-06 11:46:00 +04:00
2025-10-02 11:25:48 +05:30
2021-09-14 11:55:02 +05:30
2025-03-19 15:37:55 -07:00
2023-03-27 12:16:25 +05:30
2025-03-12 16:03:09 -07:00
2022-10-11 22:54:17 -07:00
2025-09-18 21:16:06 +05:30
2024-02-17 13:59:25 +05:30
2020-05-06 00:10:56 +05:30
2025-06-26 19:16:06 +05:30
2025-02-19 14:54:15 -08:00
2025-09-15 19:33:54 +05:30
2025-05-28 13:50:50 +05:30
2024-02-20 23:03:22 -08:00
2024-04-16 09:00:52 +05:30
2025-06-11 14:35:46 +05:30
2023-03-27 12:16:25 +05:30
2020-03-09 23:27:10 +05:30
2020-03-09 23:27:10 +05:30
2025-12-15 17:24:45 -08:00