Contact Import
Imports existing contacts into ChatWerk without sending messages or system notifications.
Use this feature only for contacts with an existing and verifiable messenger opt-in.
Description
The import process creates contacts based on a single messenger identifier and optional metadata. No outbound communication is triggered during import. Messaging must be initiated later via direct messages or campaigns. Imported contacts do not receive WhatsApp invitations or system messages.
Compliance requirements
- A valid messenger opt-in must exist prior to import
- Importing or messaging contacts without consent may result in:
- contacts reporting messages as spam
- Meta account suspension or permanent blocking
The caller is responsible for compliance with:
- GDPR
- WhatsApp / Meta messaging policies
- This endpoint must not be used for cold imports.
A contact is identified by a messenger ID, which represents the technical identifier of a specific messaging platform (e.g. WhatsApp number, Instagram ID). Each contact requires exactly one messenger ID.
Additional metadata such as names, labels, and attributes can be associated with the contact for segmentation and automation purposes.
ENDPOINT | API Reference
POST /inbox/channels/:channel_id/gateways/:gateway_id/import-conversations
Imports existing contacts without sending any messages or notifications. Use this endpoint only for contacts where a valid communication opt-in already exists. Messaging starts later via direct messages or campaigns.
Supported across all messenger platforms.
Example for txt or csv
whatsapp,name,marketing_opted_in,marketing_opted_out,labels,phone,email,shoesize,User Name,new attribute
"4912345678","Max Mustermann","2023-09-25 08:30:14","2023-09-26 09:10:59","Bestandskunde",,,,,
"4922222222","Maria Mustermann",,"2023-09-26 09:10:59",,"Label1;label2;label3",
"030398864","[email protected]","38","Mia Maria","Attr 4"Updated about 1 month ago