Creates or finds an existing contact for whatsapp, web-whatsapp, or webchat channels. For whatsapp/web-whatsapp, the contact is identified by phone number. For webchat, the contact is identified by external_user_id. Optionally assigns an agent, updates metadata, sets a stage, and upserts custom field values on the associated customer.
API key needed to authorize the request
Channel type for the contact.
whatsapp, web-whatsapp, webchat Phone number or ID of the channel. Required for whatsapp/web-whatsapp.
1UUID of the webchat channel. Required for webchat.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Stage ID to assign to the contact.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Agent ID to assign to the contact.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Phone number of the contact. Required for whatsapp/web-whatsapp.
External user identifier used to find or create the webchat contact. Required for webchat.
1Email of the contact.
Display name of the contact.
Arbitrary metadata to set on the contact.
Custom field values to upsert on the customer, identified by definition key.
Contact created or found successfully.