User
WhatsApp Unofficial Contacts
Read or manage the records shown by this feature.
Step-by-step guide
Before you start
Use the account and workspace that own the records. This page does not include administrator configuration forms.
Open this feature
Open /portal/whatsapp-unofficial/contacts on your application domain, or use the matching item in the application menu.
Steps
Create group
- Open /portal/whatsapp-unofficial/contacts on your own application domain.
- Complete these fields in that form: Group name, Description, Paste phone numbers, Or upload CSV. Their choices and limits are listed below.
- Select Create group. The exact label can change between creating and editing a record.
- If validation fails, correct the named field and submit again. After success, reopen the same record and compare the saved values.
| Field shown in the form | What to enter | Example / note |
|---|---|---|
| Group name | Required. No more than 120 characters. | Use the value required by the task; no example is assumed. |
| Description | Optional, unless this form asks for it. No more than 255 characters. | A short description of this test record. |
| Paste phone numbers | Optional, unless this form asks for it. No more than 100000 characters. | Use the value required by the task; no example is assumed. |
| Or upload CSV | Optional, unless this form asks for it. CSV: phone or phone_e164; optional name and custom columns. No more than 5120. | Use the value required by the task; no example is assumed. |
Fields shown in the interface
Only fields traced to this role’s handler and its own view are listed. The application can show separate create/edit forms; do not fill every row on one screen.
Form 1 — fields shown in the interface
| Field | What to enter or choose |
|---|---|
| Phone numbers | Required. No more than 100000 characters. |
| Consent | Required. Choose Opted in, Unknown, Opted out. |
| Contact name | Optional, unless this form asks for it. No more than 255 characters. |
| Phone number | Required. No more than 32 characters. |
Form 2 — fields shown in the interface
| Field | What to enter or choose |
|---|---|
| Group name | Required. No more than 120 characters. |
| Description | Optional, unless this form asks for it. No more than 255 characters. |
| Paste phone numbers | Optional, unless this form asks for it. No more than 100000 characters. |
| Or upload CSV | Optional, unless this form asks for it. CSV: phone or phone_e164; optional name and custom columns. No more than 5120. |
Check the result
After a source-checked procedure, verify the same record in the same workspace. Check saved values, visible state and access with the intended test account. An external payment/message/provider action needs its own result check.
Problems and validation
| Problem | Next step |
|---|---|
| A field rejects the value | Check its named error, the form’s visible choices and the relevant limit. Do not substitute internal numeric codes for the displayed options. |
| The control is missing | Check role, plan, enabled app and current record state. Do not grant administrator access merely to complete a User task. |
| The saved result is unexpected | Reopen the same record and verify its owner/workspace before repeating the action. |
Messages defined for this screen
| Message | What to review |
|---|---|
| CSV needs a header row. | Check the related field or action in this role’s form. |
| A contact can have up to 30 parameters. | Check the related field or action in this role’s form. |
| Enter a valid phone number with its country code. | Check the related field or action in this role’s form. |
| This phone number already exists in the workspace. | Check the related field or action in this role’s form. |
| Enter a key for this parameter. | Check the related field or action in this role’s form. |
| The :key key is reserved. Use the contact field above instead. | Check the related field or action in this role’s form. |
| Parameter keys must be unique. | Check the related field or action in this role’s form. |
| Group name is required. | Check the related field or action in this role’s form. |
| Paste at least one phone number or upload a CSV file. | Check the related field or action in this role’s form. |
| CSV needs a header row. | Check the related field or action in this role’s form. |
Technical reference
Role-scoped source references
Pinned commit: 68a5655db1bbe17c74fb211f0fe0ee4e63c8be88
- modules/WhatsAppUnofficial/WhatsAppUnofficialContacts/Livewire/ContactGroupPhones.php
- modules/WhatsAppUnofficial/WhatsAppUnofficialContacts/Livewire/ContactsIndex.php
- modules/WhatsAppUnofficial/WhatsAppUnofficialContacts/resources/views/livewire/group-phones.blade.php
- modules/WhatsAppUnofficial/WhatsAppUnofficialContacts/resources/views/livewire/index.blade.php
Source-only route information
| Method | Source-default route |
|---|---|
| LIVEWIRE | /portal/whatsapp-unofficial/contacts |
| LIVEWIRE | /portal/whatsapp-unofficial/contacts/{list}/phones |
Unmapped fields — not user instructions
These fields belong to this role’s source handler, but their screen labels were not confirmed.
| Source key | Handler |
|---|---|
| importFile | modules/WhatsAppUnofficial/WhatsAppUnofficialContacts/Livewire/ContactGroupPhones.php |
| editParams.*.key | modules/WhatsAppUnofficial/WhatsAppUnofficialContacts/Livewire/ContactGroupPhones.php |
| editParams.*.value | modules/WhatsAppUnofficial/WhatsAppUnofficialContacts/Livewire/ContactGroupPhones.php |
| groupConsentStatus | modules/WhatsAppUnofficial/WhatsAppUnofficialContacts/Livewire/ContactsIndex.php |