Добавление и обновление контактов
Этот метод позволяет добавлять новые контакты в WAMM.chat или обновлять информацию о существующих контактах. Полезен для синхронизации базы контактов между различными системами, автоматического обновления данных о клиентах из CRM и для добавления новых клиентов перед отправкой им сообщений. Добавление контакта не требует предварительной проверки его наличия в системе.
GET /api2/contact_to/{token}/?phone={phone}&name={name}&info={info}&email={email}&web={web}Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| token | string | Да | API-токен, полученный в настройках |
| phone | string | Да | Номер телефона в международном формате (например, 79001234567) или ID чата для Telegram |
| name | string | Да | Имя контакта |
| info | string | Нет | Примечание или заметка к контакту |
| string | Нет | Email контакта | |
| web | string | Нет | URL сайта или страницы контакта |
Ответ при успехе
{"err":0,"result":"insert"}или
{"err":0,"result":"update"}Возможные ошибки
| Код ошибки | Описание |
|---|---|
| token fail | Ошибка в токене |
| acc not authorized | Подключение не авторизовано |
| phone fail | Ошибка в номере телефона |
| no WhatsApp on the number | Нет WhatsApp с таким номером |
| no Account on the number | Нет аккаунта с таким номером для других каналов (Telegram...) |
| phone not checked for WhatsApp, please retry | Не проверен номер на наличие WhatsApp |
| phone not checked, please retry | Не проверен номер на наличие аккаунта для других каналов |
| name fail | Не указано имя |
| name fail, more 250 | Имя слишком большое, превышает 250 символов |
| web fail, more 150 | URL слишком большой, превышает 150 символов |
| email fail, more 150 | Email слишком большой, превышает 150 символов |
Примеры использования
curl -X GET "https://wamm.chat/api2/contact_to/YOUR_TOKEN/?phone=79001234567&name=Иван%20Петров&info=Новый%20клиент&email=ivan@example.com&web=https://example.com"function addOrUpdateContact($token, $phone, $name, $info = '', $email = '', $web = '') {
// Подготавливаем URL запроса
$url = "https://wamm.chat/api2/contact_to/$token/?phone=" . urlencode($phone) .
"&name=" . urlencode($name);
// Добавляем опциональные параметры, если они указаны
if (!empty($info)) {
$url .= "&info=" . urlencode($info);
}
if (!empty($email)) {
$url .= "&email=" . urlencode($email);
}
if (!empty($web)) {
$url .= "&web=" . urlencode($web);
}
// Выполняем запрос
$response = file_get_contents($url);
// Обрабатываем ответ
if ($response !== false) {
// Преобразуем ответ в массив
$json_response = json_decode($response, true);
// Проверяем наличие ошибок
if (isset($json_response['err'])) {
if ($json_response['err'] == 0 && isset($json_response['result'])) {
if ($json_response['result'] === 'insert') {
echo "Контакт успешно добавлен";
} else if ($json_response['result'] === 'update') {
echo "Контакт успешно обновлен";
}
return true;
} else {
echo "Ошибка: " . $json_response['err'];
}
} else {
echo "Не удалось обработать ответ от сервера";
}
} else {
echo "Не удалось выполнить запрос к серверу";
}
return false;
}
// Используем функцию для добавления или обновления контакта
$token = "YOUR_TOKEN";
$phone = "79001234567";
$name = "Иван Петров";
$info = "Новый клиент";
$email = "ivan@example.com";
$web = "https://example.com";
addOrUpdateContact($token, $phone, $name, $info, $email, $web);