Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fixes #77 - Whatsapp: added explanation and screenshot for custom reminder message #779

Merged
merged 1 commit into from
Feb 28, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions channels/whatsapp/setup.rst
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,11 @@ Automatic Reminders
`conversation description <https://developers.facebook.com/docs/whatsapp/pricing#customer-service-windows>`_
under "Customer Service Windows".

Reminder Message
If you want to use a custom reminder message before the 24-hour customer
service window closes, you can insert it here. Leave it empty to stay with
the default message.

Target Group
Here you can define the :doc:`group </manage/groups/index>` in which the
ticket should be created.
Expand Down
Binary file modified images/channels/whatsapp/setup-step-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
42 changes: 25 additions & 17 deletions locale/admin-docs.pot
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Zammad Admin Documentation pre-release\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-01-10 11:58+0100\n"
"POT-Creation-Date: 2025-02-28 13:09+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <[email protected]>\n"
Expand Down Expand Up @@ -5143,87 +5143,95 @@ msgstr ""
msgid "For more information on 24-hour customer service windows, take a look at Meta's `conversation description <https://developers.facebook.com/docs/whatsapp/pricing#customer-service-windows>`_ under \"Customer Service Windows\"."
msgstr ""

#: ../channels/whatsapp/setup.rst:94
msgid "Target Group"
#: ../channels/whatsapp/setup.rst:95
msgid "Reminder Message"
msgstr ""

#: ../channels/whatsapp/setup.rst:93
msgid "If you want to use a custom reminder message before the 24-hour customer service window closes, you can insert it here. Leave it empty to stay with the default message."
msgstr ""

#: ../channels/whatsapp/setup.rst:99
msgid "Target Group"
msgstr ""

#: ../channels/whatsapp/setup.rst:98
msgid "Here you can define the :doc:`group </manage/groups/index>` in which the ticket should be created."
msgstr ""

#: ../channels/whatsapp/setup.rst:96
#: ../channels/whatsapp/setup.rst:101
msgid "After entering your data, click on **Submit**. After this step, the WhatsApp channel is technically created. However, there is another important step to take."
msgstr ""

#: ../channels/whatsapp/setup.rst:101
#: ../channels/whatsapp/setup.rst:106
msgid "Step 3"
msgstr ""

#: ../channels/whatsapp/setup.rst:103
#: ../channels/whatsapp/setup.rst:108
msgid "This third step is about telling WhatsApp where they should send their data:"
msgstr ""

#: ../channels/whatsapp/setup.rst:105
#: ../channels/whatsapp/setup.rst:110
msgid "If you don't follow the instructions properly, your account shows up but you aren't able to receive messages (because Meta/WhatsApp doesn't know where to send them)!"
msgstr ""

#: ../channels/whatsapp/setup.rst:None
msgid "Step 3 of adding a WhatsApp account"
msgstr ""

#: ../channels/whatsapp/setup.rst:120
#: ../channels/whatsapp/setup.rst:125
msgid "Callback URL"
msgstr ""

#: ../channels/whatsapp/setup.rst:115
#: ../channels/whatsapp/setup.rst:120
msgid "Click on the copy icon on the right side and head over to your WhatsApp business app. Enter the copied URL in the corresponding field in your app. You can find it in your `\"App Dashboard\" <https://developers.facebook.com/apps/>`_ under \"WhatsApp > Configuration > Webhook > Callback URL\" (see screenshot below). Paste it there."
msgstr ""

#: ../channels/whatsapp/setup.rst:133
#: ../channels/whatsapp/setup.rst:138
msgid "Verify Token"
msgstr ""

#: ../channels/whatsapp/setup.rst:123
#: ../channels/whatsapp/setup.rst:128
msgid "Copy this string too. Enter it directly below the pasted Callback URL."
msgstr ""

#: ../channels/whatsapp/setup.rst:0
msgid "Configuration section in WhatsApp app dashboard"
msgstr ""

#: ../channels/whatsapp/setup.rst:128
#: ../channels/whatsapp/setup.rst:133
msgid "After entering your data, click on **Verify and save** which triggers a check if your system is accessible and configured correctly."
msgstr ""

#: ../channels/whatsapp/setup.rst:0
msgid "Webhook dialog"
msgstr ""

#: ../channels/whatsapp/setup.rst:151
#: ../channels/whatsapp/setup.rst:156
msgid "Define webhook fields"
msgstr ""

#: ../channels/whatsapp/setup.rst:136
#: ../channels/whatsapp/setup.rst:141
msgid "Finally, go to the field below in the app dashboard and select \"Manage\" in the \"Webhook fields\" section. This is needed that you'll get the message as content:"
msgstr ""

#: ../channels/whatsapp/setup.rst:0
msgid "Select webhook fields in app dashboard"
msgstr ""

#: ../channels/whatsapp/setup.rst:143
#: ../channels/whatsapp/setup.rst:148
msgid "Subscribe to \"messages\" by clicking in the checkbox:"
msgstr ""

#: ../channels/whatsapp/setup.rst:0
msgid "Select \"message\" as webhook field"
msgstr ""

#: ../channels/whatsapp/setup.rst:150
#: ../channels/whatsapp/setup.rst:155
msgid "You should now see the selected \"messages\" under the \"Webhook fields\" caption as in the first screenshot."
msgstr ""

#: ../channels/whatsapp/setup.rst:153
#: ../channels/whatsapp/setup.rst:158
msgid "After finishing this step, you can click on the **Finish** button in Zammad and you should now be ready to receive tickets from your WhatsApp channel!"
msgstr ""

Expand Down