WhatsApp Business
For technical contacts – which WhatsApp number Nimmi uses, own numbers via Meta, message templates, the 24-hour window, consent and opt-out.
This page explains how WhatsApp works behind the scenes. The setup steps are in Connect WhatsApp.
Which number Nimmi uses
This is the standard. Your account's Nimmi phone number (see Phone number and voice) is registered as a WhatsApp sender in UrbanGround's WhatsApp Business account, through Twilio. Applicants see the same number for calls and WhatsApp. The display name is "Urban Ground" unless agreed otherwise.
This needs a plan with a phone number and the WhatsApp feature, which UrbanGround enables per account.
Connecting your own WhatsApp Business number through Meta (Connect my own number) is prepared but not available in live operation yet: the Meta app needed for the connection is not set up yet. The button is shown, but the connection cannot be completed.
From e-mail to WhatsApp
Every e-mail to an applicant has the "Prefer WhatsApp or a call?" note above the imprint, with a WhatsApp link to this number (the number is written out beside it). The link prefills "Hallo Nimmi (code)"; when the applicant sends it, the WhatsApp chat joins their existing enquiry and Nimmi answers with the history. The code works once and expires after the configured period. When WhatsApp is not connected or switched off for the listing, the WhatsApp line is left out. See E-mail intake.
Message templates
WhatsApp only allows free text within 24 hours of the applicant's last message. For everything else, Nimmi uses message templates approved by Meta – for example the first message, viewing confirmations and reminders, and reopening a closed conversation.
- Templates exist in German and English and are managed by UrbanGround; you cannot write your own.
- A template can only be used once Meta has approved it. Until then the app shows Template is still being reviewed by WhatsApp.
- Two templates are marketing messages (asking permission for future offers, and a new matching flat); all others are service (utility) messages.
The full list with purposes is in WhatsApp templates.
The 24-hour window
- The window opens with every message from the applicant and is counted per chat.
- Inside it, Nimmi and you can write freely.
- Outside it, only templates go out. Nimmi switches follow-ups to templates automatically. In the inbox you can send one Reopen conversation template per closed window; if Nimmi has already sent hers, you cannot send another.
- The inbox shows the remaining time, for example Reply window: 5 h left, or Reply window closed.
Consent before the first message
Nimmi writes to an applicant first on WhatsApp only with their consent – for example because they wrote first, or switched from e-mail to WhatsApp via Nimmi's link. The account setting First contact on WhatsApp is Only with consent by default. The alternative, writing to all enquiries with a mobile number, requires the admin to accept a legal notice first.
Every first message carries the opt-out line, and Nimmi's first reply starts with a note that she is an AI assistant.
Opt-out
- An applicant who sends STOP, STOPP or ABMELDEN as the whole message receives one confirmation and no further WhatsApp messages – from Nimmi or from you.
- There is no START keyword: an applicant who writes again on their own has consented again. Reactions and stickers do not count.
- An opt-out from an unknown number is stored only as a one-way hash of the number.
What applicants can send
Text, voice notes, images and documents. Voice notes are transcribed for you; files are checked for viruses before you can open them.
Not available
- WhatsApp alerts to you (Coming soon, while the platform cannot send them yet).
- Sending files from the inbox on WhatsApp.
- Your own WhatsApp Business number in live operation (see above).
Related pages
Last updated: