Quick navigation:
- Use cases
- Before you start
- How to set it up
- Troubleshooting
- Restrictions & Limitations
- Tips & Tricks
- FAQs
Use cases
- Reach guests on the app they actually use. For many guests, WeChat is their main communication platform, and they will not open an email or answer a WhatsApp message. Connecting your Official Account gives them a way to reach you, and gives you a way to reach them, on the channel they check all day
- Answer repeat questions with templates instead of retyping them. Questions like check-in time, address and directions, parking, and Wi-Fi come in over and over. Map those answers once as WeChat templates, then send the right one in a couple of clicks with the guest and company details already filled in from Duve dynamic parameters
- Keep WeChat in the same inbox as everything else. Your team answers WeChat conversations in the Communication Hub alongside your other channels, so nobody has to watch a separate app
- Handle photo-based requests. A guest sends a picture of a broken air conditioner or a damaged item, and your team sees the image in the conversation and acts on it
Before you start
- You need a WeChat Official Account with its App ID, App Secret, and account identifier (the WeChat User)
- You need Duve user permissions to edit Settings → Connections → Messaging Providers
- If you plan to use templates, create your private message templates in your WeChat Official Account first. Duve pulls in your existing private templates; it does not create them
- To receive inbound messages, your WeChat Official Account must send events to Duve's webhook. After you connect, Duve shows the inbound URL for your provider in this format:
https://<your-Duve-hostname>/api/messaging/inbound/wechat/{providerExternalId} - Webhook verification uses a token and an encoding (AES) key that Duve manages. To finish webhook setup on the WeChat side, contact Duve Support for the exact values to enter in your Official Account
How to set it up
Set up on the WeChat side
-
3 required fields should be filled from the host WeChat account
- Username
- App ID
- App secret
-
To fill those fields, the host should enter their WeChat account: Go to Setup and Development → Development Interface
-
Enter the developer platform
-
Verification step (might include a QR scan step by the host)
-
Click on Service Account
-
Under the Basic tab, copy the following fields:
- Original ID → Into the Username field in Duve
- AppID → Into the App ID field in Duve
- Create AppSecret (under Development Key section)
-
In Duve: Go to Settings → Connections → Messaging Providers → Create new connection → Select "WeChat"
- Enter your WeChat Username, App ID, and App Secret. You can also add an internal nickname to identify this connection.
- Click Connect. Duve verifies your details by fetching your private templates, so invalid details fail the connection
- Once the connection is active, you are taken to the connection page, where you can view the auto-created Webhook URL and edit the connection details:
- Go back to the WeChat developers platform and configure the webhook
-
Click on Enable under Push notifications
- Paste the URL from the frontdesk
- Duve member should provide the host with the Token and the EncodingAESKey
- Select Safe mode (encrypted payload) or Plain text mode
-
Submit
WeChat templates
This page appears once you have an active WeChat connection. It lists the private templates from your WeChat account, and your job in Duve is to map each WeChat placeholder to a Duve dynamic parameter so the template is ready to send.
- Go to Settings → Communication → WeChat Templates
-
If no templates are assigned to your account yet, the page shows an empty state with a button to open your WeChat Official Account. Add templates there, then return
- Click Sync templates to pull in the latest private templates from your WeChat account
- Check the status of each template:
- Action needed: the template still has placeholders that are not mapped, so it cannot be used yet
-
Ready: every placeholder is mapped, and the template can be used by your team
- Click a template to open the editor. It shows the template content and each WeChat placeholder next to a field where you choose a Duve dynamic parameter
- Map every placeholder to a Duve dynamic parameter, then click Submit. When all placeholders are mapped, the template becomes Ready
- Ready templates appear as canned responses in the Communication Hub, so your team can pick them straight from a conversation
Messaging from the Communication Hub
WeChat is not a message type you can select in the composer. A WeChat conversation starts only when a guest sends a message to your Official Account. That inbound message opens a conversation with the WeChat message type, and every reply in it goes out through WeChat.
- A WeChat conversation stays on WeChat. It cannot be changed to any other messaging type
- A WeChat conversation cannot be connected to a reservation
To reply to a guest:
- Open the guest's WeChat conversation in the Communication Hub
- Compose and send:
- For text, type and send
- For an image, attach it and send
- For a template, open the canned responses, choose a Ready WeChat template, review it, and send
- Use the composer translation controls if translation is enabled on your account
Troubleshooting
- Cannot connect the provider: Recheck your WeChat User, App ID, and App Secret. Duve verifies these by fetching your private templates, so invalid details fail the connection
- Incoming messages never arrive: Confirm your WeChat Official Account points to the correct Duve inbound URL and that webhook verification is complete. If a token or encoding key is required, contact Duve Support to finish the setup
- A guest sent a voice, video, or file message and it did not appear: Only inbound text and image messages are processed for WeChat
- The host cannot send on WeChat: Make sure the WeChat connection is active, the guest chat has a linked WeChat recipient, and an access token can be obtained
- An image fails to send: The image must first upload to WeChat temporary media. If that upload fails, the message is not sent. Try a different image or send again later
- A template is not available to send: Sync your private templates and map every placeholder. A template stays in Action needed, and out of the canned responses, until all placeholders are mapped
- A message is rejected with a provider error: Duve records WeChat's error code and does not retry automatically. Check your WeChat account status and messaging permissions
Restrictions & Limitations
- Inbound messages support text and image only. Other inbound types are ignored
- Outbound content supports text, image, and mapped WeChat private templates
- Text and an image cannot be combined into one WeChat message. They are sent as two separate messages
- There are no broadcasts, quick replies, buttons, or interactive menus
- There are no document, video, audio, or location messages
- Duve does not create or submit new WeChat templates. Only the private templates already in your WeChat account can be synced and used
- Duve does not generate WeChat QR codes or deep links
- Duve does not display or enforce a WeChat messaging-session timer. Delivery depends on WeChat's own account rules and messaging window, and a send that WeChat rejects is shown with the provider error
- Duve strips HTML before sending, so use plain text. Emojis behave as regular text, subject to WeChat acceptance
Tips & Tricks
- Keep messages concise and in plain text to avoid formatting being stripped by WeChat
- Map every placeholder in a template to move it to Ready, then test with your own WeChat account before using it with guests
-
Add an internal nickname to each connection so your team can tell which WeChat account its templates come from
FAQs
Q: What kind of WeChat account do I need?
A: A WeChat Official Account that provides an App ID, App Secret, and account identifier (the WeChat User). Duve does not integrate with WeCom or Mini Program customer service.
Q: How do guests start a WeChat chat with us?
A: Guests message your connected Official Account. Duve links the conversation using the guest's WeChat user identifier when the message arrives.
Q: Can I broadcast messages to a segment of guests on WeChat?
A: No. Broadcasts are not supported in Duve's WeChat channel.
Q: Can I send files, videos, or voice messages?
A: No. Outbound messages support text, images, and mapped WeChat private templates.
Q: Can I include both text and an image in one message?
A: No. Text and an image are sent as two separate WeChat messages.
Q: Can Duve create or approve WeChat templates for me?
A: No. Duve syncs the private templates already in your WeChat account. You map each placeholder to a Duve dynamic parameter, then send the template from the Communication Hub.
Q: Why does a template show Action needed?
A: It still has at least one placeholder that is not mapped to a Duve dynamic parameter. Open the template, map the remaining placeholders, and click Submit.
Q: Does translation work with WeChat?
A: Yes. WeChat conversations use Duve's standard Communication Hub translation controls when translation is enabled for your account.
Q: Where do I see WeChat analytics?
A: WeChat conversations appear in the Communication Hub. There is no WeChat-specific analytics dashboard in Duve.
Comments
0 comments
Article is closed for comments.