> For the complete documentation index, see [llms.txt](https://help.onebot.tech/onebot-help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.onebot.tech/onebot-help/bloki-konstruktora/integracii/setcontactbywhatsappphone.md).

# setContactByWhatsAppPhone()

{% hint style="info" %}
Эта функция предназначена для блока "**Входящий Webhook**" и будет работать только в нем.
{% endhint %}

### Синтаксис <a href="#sintaksis" id="sintaksis"></a>

```
setContactByWhatsAppPhone(phone, name)
```

* `phone` - (строка) телефон пользователя без знака "+".
* `name` - (строка) (не обязательно) имя пользователя. Если передать этот аргумент, то функция создаст новый контакт с указанными номером телефона и именем, если контакт не найден по такому номеру телефона.

### Возвращаемые значения <a href="#vozvrashaemye-znacheniya" id="vozvrashaemye-znacheniya"></a>

* Логический

### Пример <a href="#primer" id="primer"></a>

В этом примере устанавливается существующий контакт на платформе с номером телефона "71234567890".

```
var success = setContactByWhatsAppPhone("71234567890");
if (success) {
    // Контакт успешно установлен
}
```

В этом примере устанавливается несуществующий контакт на платформе с номером телефона "71234567890".

```
var success = setContactByWhatsAppPhone("71234567890", "Иван");
if (success) {
    // Контакт успешно создан и установлен
}
```

{% hint style="info" %}
В одном скрипте такую функцию можно вызвать только 1 раз.
{% endhint %}