(#751)

* Align the 2.17 contacts endpoints with what the API sends and accepts

Adds the fields, parameters and error responses the contacts endpoints
use but the spec left out, corrects the search field and operator
tables and the avatar type, and adds the OAuth scopes each endpoint
accepts to its description.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* Document the missing-scope 401 on the 2.17 contacts endpoints

Adds the token_unauthorized example to each contacts endpoint's 401 response.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* Note that the detach response still counts the contact in user_count

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* Correct the IN/NIN value limit, email_verified on list and search, and the merge preview phone match

Each IN or NIN value counts toward the 15-condition group limit, so 15 is the effective cap. List and search contacts do return email_verified. The merge preview duplicate check also matches the source phone against the destination WhatsApp number.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* Drop the detach user_count note and correct the per_page, search and conflict errors

The detach response re-reads the company after the contact is removed, so
its user_count already excludes the contact. Also documents the user-to-lead
400 on update, the two other create 409s, the 15-condition search error, and
how per_page, starting_after, order and escape_identity really behave.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* Correct the multiple-match 409 example, referrer and the iOS/Android search fields

The multiple-match 409 on create only happens when no external_id is sent,
so its message has nothing after id=. referrer is overwritten whenever the
Messenger reports one, so it isn't the first-seen page. The ios_* and
android_* search fields also become searchable once the SDK is set up in
the workspace, before any request from it.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* Port the Contacts corrections from 2.17 to Preview

Applies the 2.17 Contacts changes from #751 to the Preview spec, merged
operation by operation so Preview-only content is kept: user-to-user merge
and its merge_users scope, the fuller language_override description, and
whatsapp_number. The email_verified note no longer says the field is
Preview-only, since 2.17 returns it.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* Correct the multiple-match 409 example, referrer and the iOS/Android search fields in Preview

The multiple-match 409 on create only happens when no external_id is sent,
so its message has nothing after id=. referrer is overwritten whenever the
Messenger reports one, so it isn't the first-seen page. The ios_* and
android_* search fields also become searchable once the SDK is set up in
the workspace, before any request from it.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

Author: markdennis22