Данный метод позволяет получить подробную информацию о контакте или чате по номеру телефона или chat_id (для Telegram). Возвращает данные из WAMM.chat о контакте, включая его имя, email, аватар, заметки, теги и настройки чата. Полезен для синхронизации контактных данных с внешними системами и CRM.
GET /api2/contact_get/{token}/{phone}
Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|
| token | string | Да | API-токен, полученный в настройках |
| phone | string | Да | Номер телефона в международном формате или ID чата (для Telegram) |
Ответ при успехе
{
"err": 0,
"data": {
"api_id": 100,
"tip": "user",
"phone": "79001234567",
"name": "Chat Name",
"email": "",
"web": "",
"avatar": "https://wamm.chat/avatar.jpg",
"notes": "",
"user_id": "",
"tags": "tag1; tag2",
"chat_banned": 0,
"chat_mute": 1,
"chat_favorite": 0
}
}
Описание полей ответа
| Поле | Описание |
|---|
| api_id | Номер канала |
| tip | Тип контакта ("user" - пользователь, "group" - группа) |
| phone | Номер телефона контакта. Для Telegram, MAX - ID чата |
| phone_real | Телефон/Никнейм, если известен, для Telegram, MAX, где phone - ID чата |
| name | Имя контакта или название чата |
| email | Email контакта |
| web | URL контакта |
| avatar | URL аватара контакта |
| notes | Заметки к контакту |
| user_id | ID пользователя, закрепленного за чатом (ответственного) |
| tags | Теги, разделенные точкой с запятой (;) |
| chat_banned | Статус блокировки (0 - не заблокирован, 1 - заблокирован) |
| chat_mute | Статус уведомлений (0 - уведомления включены, 1 - уведомления отключены) |
| chat_favorite | Статус закрепления вверху списка (0 - не закреплен, 1 - закреплен) |
Возможные ошибки
| Код ошибки | Описание |
|---|
| token fail | Ошибка в токене |
| not found | Контакт не найден |
| phone fail | Ошибка в номере телефона |
Примеры использования