ΠŸΠ΅Ρ€Π΅ΠΉΡ‚ΠΈ ΠΊ ΡΠΎΠ΄Π΅Ρ€ΠΆΠ°Π½ΠΈΡŽ

SendContact#

Test Postman Apidog

ΠœΠ΅Ρ‚ΠΎΠ΄ ΠΏΡ€Π΅Π΄Π½Π°Π·Π½Π°Ρ‡Π΅Π½ для ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠΈ сообщСния с ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚ΠΎΠΌ. ЀормируСтся визитная ΠΊΠ°Ρ€Ρ‚ΠΎΡ‡ΠΊΠ° ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚Π° ΠΈ отправляСтся Π² Ρ‡Π°Ρ‚. Π‘ΠΎΠΎΠ±Ρ‰Π΅Π½ΠΈΠ΅ Π±ΡƒΠ΄Π΅Ρ‚ Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ΠΎ Π² ΠΎΡ‡Π΅Ρ€Π΅Π΄ΡŒ Π½Π° ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΡƒ. Π‘ΠΎΠΎΠ±Ρ‰Π΅Π½ΠΈΠ΅ Π½Π° ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΡƒ хранится 24 часа Π² ΠΎΡ‡Π΅Ρ€Π΅Π΄ΠΈ ΠΈ Π±ΡƒΠ΄Π΅Ρ‚ ΠΎΡ‚ΠΏΡ€Π°Π²Π»Π΅Π½ΠΎ сразу ΠΆΠ΅ послС Π°Π²Ρ‚ΠΎΡ€ΠΈΠ·Π°Ρ†ΠΈΠΈ Ρ‚Π΅Π»Π΅Ρ„ΠΎΠ½Π°. Π‘ΠΊΠΎΡ€ΠΎΡΡ‚ΡŒ ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠΈ сообщСний ΠΈΠ· ΠΎΡ‡Π΅Ρ€Π΅Π΄ΠΈ Ρ€Π΅Π³ΡƒΠ»ΠΈΡ€ΡƒΠ΅Ρ‚ ΠΏΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€ Π˜Π½Ρ‚Π΅Ρ€Π²Π°Π» ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠΈ сообщСний.

Запрос#

Для ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠΈ сообщСния с ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚ΠΎΠΌ трСбуСтся Π²Ρ‹ΠΏΠΎΠ»Π½ΠΈΡ‚ΡŒ запрос ΠΏΠΎ адрСсу:

POST
{{apiUrl}}/waInstance{{idInstance}}/sendContact/{{apiTokenInstance}}

Для получСния ΠΏΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€ΠΎΠ² запроса apiUrl, idInstance ΠΈ apiTokenInstance ΠΎΠ±Ρ€Π°Ρ‚ΠΈΡ‚Π΅ΡΡŒ ΠΊ Ρ€Π°Π·Π΄Π΅Π»Ρƒ ΠŸΠ΅Ρ€Π΅Π΄ Π½Π°Ρ‡Π°Π»ΠΎΠΌ Ρ€Π°Π±ΠΎΡ‚Ρ‹.

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹ запроса#

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€ Π’ΠΈΠΏ ΠžΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½Ρ‹ΠΉ ОписаниС
chatId string Π”Π° Π˜Π΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€ Ρ‡Π°Ρ‚Π°
contact object Π”Π° ΠžΠ±ΡŠΠ΅ΠΊΡ‚ ΠΎ ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚Π΅
quotedMessageId string НСт Π˜Π΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€ Ρ†ΠΈΡ‚ΠΈΡ€ΡƒΠ΅ΠΌΠΎΠ³ΠΎ сообщСния. ΠŸΡ€ΠΈ Π·Π°ΠΏΠΎΠ»Π½Π΅Π½ΠΈΠΈ ΠΏΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Π° сообщСниС отправится с Ρ†ΠΈΡ‚ΠΈΡ€ΠΎΠ²Π°Π½ΠΈΠ΅ΠΌ ΡƒΠΊΠ°Π·Π°Π½Π½ΠΎΠ³ΠΎ сообщСния Ρ‡Π°Ρ‚Π°.
Π¦ΠΈΡ‚ΠΈΡ€ΠΎΠ²Π°Π½ΠΈΠ΅ сообщСния Π²ΠΎΠ·ΠΌΠΎΠΆΠ½ΠΎ Ρ‚ΠΎΠ»ΡŒΠΊΠΎ ΠΈΠ· Ρ‚ΠΎΠ³ΠΎ ΠΆΠ΅ Ρ‡Π°Ρ‚Π°, Π² ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ производится ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠ°.
Для ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠΈ сообщСний ΠΈΠ· Π΄Ρ€ΡƒΠ³ΠΎΠ³ΠΎ Ρ‡Π°Ρ‚Π° ΠΈΡΠΏΠΎΠ»ΡŒΠ·ΡƒΠ΅Ρ‚ΡΡ ΠΌΠ΅Ρ‚ΠΎΠ΄ ForwardMessages
typingTime integer НСт ВрСмя ΠΏΠΎΠΊΠ°Π·Π° увСдомлСния Π½Π°Π±ΠΎΡ€Π° сообщСния Π² Ρ‡Π°Ρ‚Π΅ собСсСдника.
ВрСмя ΠΎΠ³Ρ€Π°Π½ΠΈΡ‡Π΅Π½ΠΎ значСниями ΠΎΡ‚ 1000 Π΄ΠΎ 20000 миллисСкунд (ΠΎΡ‚ 1 Π΄ΠΎ 20 сСкунд).

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹ ΠΎΠ±ΡŠΠ΅ΠΊΡ‚Π° contact:

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€ Π’ΠΈΠΏ ΠžΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½Ρ‹ΠΉ ОписаниС
phoneContact integer Π”Π° Π½ΠΎΠΌΠ΅Ρ€ Ρ‚Π΅Π»Π΅Ρ„ΠΎΠ½Π° ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚Π° Π² ΠΌΠ΅ΠΆΠ΄ΡƒΠ½Π°Ρ€ΠΎΠ΄Π½ΠΎΠΌ Ρ„ΠΎΡ€ΠΌΠ°Ρ‚Π΅ (Π±Π΅Π· +) 11 ΠΈΠ»ΠΈ 12 Ρ†ΠΈΡ„Ρ€
firstName string Если Π½Π΅ ΡƒΠΊΠ°Π·Π°Π½Ρ‹ middleName, lastName, company Имя ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚Π°
middleName string Если Π½Π΅ ΡƒΠΊΠ°Π·Π°Π½Ρ‹ firstName, lastName, company ΠžΡ‚Ρ‡Π΅ΡΡ‚Π²ΠΎ ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚Π°
lastName string Если Π½Π΅ ΡƒΠΊΠ°Π·Π°Π½Ρ‹ middleName, firstName, company Ѐамилия ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚Π°
company string Если Π½Π΅ ΡƒΠΊΠ°Π·Π°Π½Ρ‹ middleName, lastName, firstName НазваниС ΠΊΠΎΠΌΠΏΠ°Π½ΠΈΠΈ ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚Π°

Π¦ΠΈΡ‚ΠΈΡ€ΠΎΠ²Π°Π½ΠΈΠ΅ сообщСний

Для ΠΊΠΎΡ€Ρ€Π΅ΠΊΡ‚Π½ΠΎΠΉ Ρ€Π°Π±ΠΎΡ‚Ρ‹ с ΠΌΠ΅Ρ…Π°Π½ΠΈΠ·ΠΌΠΎΠΌ цитирования сообщСний систСма Π΄ΠΎΠ»ΠΆΠ½Π° Π·Π½Π°Ρ‚ΡŒ ΠΎ сообщСнии, ΠΊΠΎΡ‚ΠΎΡ€ΠΎΠ΅ Π±ΡƒΠ΄Π΅Ρ‚ ΠΏΡ€ΠΎΡ†ΠΈΡ‚ΠΈΡ€ΠΎΠ²Π°Π½ΠΎ. УбСдится ΠΎ Ρ‚ΠΎΠΌ Ρ‡Ρ‚ΠΎ сообщСниС доступно ΠΊ Ρ†ΠΈΡ‚ΠΈΡ€ΠΎΠ²Π°Π½ΠΈΡŽ ΠΌΠΎΠΆΠ½ΠΎ запросив ΠΌΠ΅Ρ‚ΠΎΠ΄ Турналирования getMessage, Ссли сообщСниС отсутствуСт Π² систСмС, Ρ‚ΠΎ Ρ†ΠΈΡ‚ΠΈΡ€ΠΎΠ²Π°Ρ‚ΡŒ Ρ‚Π°ΠΊΠΎΠ΅ сообщСниС Π½Π΅Π²ΠΎΠ·ΠΌΠΎΠΆΠ½ΠΎ.

  • Для цитирования входящих сообщСний Π½Π΅ΠΎΠ±Ρ…ΠΎΠ΄ΠΈΠΌΠΎ Π²ΠΊΠ»ΡŽΡ‡ΠΈΡ‚ΡŒ настройку ΠŸΠΎΠ»ΡƒΡ‡Π°Ρ‚ΡŒ увСдомлСния ΠΎ входящих сообщСниях ΠΈ Ρ„Π°ΠΉΠ»Π°Ρ….

  • Для цитирования исходящих сообщСний ΠΎΡ‚ΠΏΡ€Π°Π²Π»Π΅Π½Π½Ρ‹Ρ… с Ρ‚Π΅Π»Π΅Ρ„ΠΎΠ½Π°, Π²ΠΊΠ»ΡŽΡ‡ΠΈΡ‚Π΅ настройку ΠŸΠΎΠ»ΡƒΡ‡Π°Ρ‚ΡŒ увСдомлСния ΠΎ сообщСниях, ΠΎΡ‚ΠΏΡ€Π°Π²Π»Π΅Π½Π½Ρ‹Ρ… с Ρ‚Π΅Π»Π΅Ρ„ΠΎΠ½Π°.
    Π’Π°ΠΊ сообщСния Π±ΡƒΠ΄ΡƒΡ‚ ΠΏΠΎΠΏΠ°Π΄Π°Ρ‚ΡŒ Π² систСму ΠΈ ΠΈΡ… ΠΌΠΎΠΆΠ½ΠΎ Π±ΡƒΠ΄Π΅Ρ‚ Ρ†ΠΈΡ‚ΠΈΡ€ΠΎΠ²Π°Ρ‚ΡŒ.

Установку настроСк ΠΌΠΎΠΆΠ½ΠΎ ΡΠ΄Π΅Π»Π°Ρ‚ΡŒ ΠΌΠ΅Ρ‚ΠΎΠ΄ΠΎΠΌ SetSettings ΠΈΠ»ΠΈ Ρ‡Π΅Ρ€Π΅Π· Π»ΠΈΡ‡Π½Ρ‹ΠΉ ΠΊΠ°Π±ΠΈΠ½Π΅Ρ‚.

ΠŸΡ€ΠΈΠΌΠ΅Ρ€ Ρ‚Π΅Π»Π° запроса#

ΠžΡ‚ΠΏΡ€Π°Π²ΠΊΠ° сообщСния Π² Π»ΠΈΡ‡Π½Ρ‹ΠΉ Ρ‡Π°Ρ‚:

{
    "chatId": "79876543210@c.us",
    "contact": {
        "phoneContact": 79001234567,
        "firstName": "АртСм",
        "middleName": "ΠŸΠ΅Ρ‚Ρ€ΠΎΠ²ΠΈΡ‡",
        "lastName": "Евпаторийский",
        "company": "ВСлосипСд"
    }
}

ΠžΡ‚ΠΏΡ€Π°Π²ΠΊΠ° сообщСния Π² Π³Ρ€ΡƒΠΏΠΏΠΎΠ²ΠΎΠΉ Ρ‡Π°Ρ‚:

{
    "chatId": "120363043968066561@g.us",
    "contact": {
        "phoneContact": 79001234567,
        "firstName": "АртСм",
        "middleName": "ΠŸΠ΅Ρ‚Ρ€ΠΎΠ²ΠΈΡ‡",
        "lastName": "Евпаторийский",
        "company": "ВСлосипСд"
    }
}

ΠžΡ‚ΠΏΡ€Π°Π²ΠΊΠ° сообщСния с Ρ†ΠΈΡ‚ΠΈΡ€ΠΎΠ²Π°Π½ΠΈΠ΅ΠΌ:

{
    "chatId": "79876543210@c.us",
    "quotedMessageId": "361B0E63F2FDF95903B6A9C9A102F34B",
    "contact": {
        "phoneContact": 79001234567,
        "firstName": "АртСм",
        "middleName": "ΠŸΠ΅Ρ‚Ρ€ΠΎΠ²ΠΈΡ‡",
        "lastName": "Евпаторийский",
        "company": "ВСлосипСд"
    }
}

ΠžΡ‚Π²Π΅Ρ‚#

Поля ΠΎΡ‚Π²Π΅Ρ‚Π°#

ПолС Вип ОписаниС
idMessage string Π˜Π΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€ ΠΎΡ‚ΠΏΡ€Π°Π²Π»Π΅Π½Π½ΠΎΠ³ΠΎ сообщСния

ΠŸΡ€ΠΈΠΌΠ΅Ρ€ Ρ‚Π΅Π»Π° ΠΎΡ‚Π²Π΅Ρ‚Π°#

{
    "idMessage": "3EB0C767D097B7C7C030"
}

Ошибки SendContact#

ΠŸΠ΅Ρ€Π΅Ρ‡Π΅Π½ΡŒ ΠΎΠ±Ρ‰ΠΈΡ… для всСх ΠΌΠ΅Ρ‚ΠΎΠ΄ΠΎΠ² ошибок смотритС Π² Ρ€Π°Π·Π΄Π΅Π»Π΅ Π‘Ρ‚Π°Π½Π΄Π°Ρ€Ρ‚Π½Ρ‹Π΅ ошибки

Код HTTP Π˜Π΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€ ошибки ОписаниС
400 Bad Request
Validation failed
Ошибка Π²Π°Π»ΠΈΠ΄Π°Ρ†ΠΈΠΈ
400 Validation failed.
Details: 'value' must have at least 1 key
ПолС value Π΄ΠΎΠ»ΠΆΠ½ΠΎ ΡΠΎΠ΄Π΅Ρ€ΠΆΠ°Ρ‚ΡŒ ΠΌΠΈΠ½ΠΈΠΌΡƒΠΌ 1 символ
400 Validation failed.
Details: 'contact.phoneContact' must be a number
НСвСрный Ρ‚ΠΈΠΏ Π΄Π°Π½Π½Ρ‹Ρ… поля contact.phoneContact
400 Validation failed.
Details: 'contact.phoneContact' must be a safe number
Π—Π½Π°Ρ‡Π΅Π½ΠΈΠ΅ поля contact.phoneContact ΠΏΡ€Π΅Π²Ρ‹ΡˆΠ°Π΅Ρ‚ максимальноС бСзопасноС цСлочислСнноС Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅
500 Internal Server Error
request entity too large
ΠŸΡ€Π΅Π²Ρ‹ΡˆΠ΅Π½ΠΈΠ΅ допустимой Π΄Π»ΠΈΠ½Ρ‹ json (>100ΠΊΠ±)

ΠžΡ‚ΠΏΡ€Π°Π²ΠΊΠ° с Π½Π΅Π²Π΅Ρ€Π½Ρ‹ΠΌ ΠΈΠ΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€ΠΎΠΌ Ρ†ΠΈΡ‚ΠΈΡ€ΡƒΠ΅ΠΌΠΎΠ³ΠΎ сообщСния

Π’ случаС Π½Π΅ΠΊΠΎΡ€Ρ€Π΅ΠΊΡ‚Π½ΠΎΠ³ΠΎ указания quotedMessageId, систСма Π²Π΅Ρ€Π½Ρ‘Ρ‚ ΠΊΠΎΠ΄ 200 ΠΈ id отправляСмого сообщСния, Π½ΠΎ ΠΎΠ½ΠΎ Π½Π΅ Π±ΡƒΠ΄Π΅Ρ‚ доставлСно ΠΏΠΎΠ»ΡƒΡ‡Π°Ρ‚Π΅Π»ΡŽ.

ΠŸΡ€ΠΈΠΌΠ΅Ρ€Ρ‹ ΠΊΠΎΠ΄Π°#

import requests

url = "{{apiUrl}}/waInstance{{idInstance}}/sendContact/{{apiTokenInstance}}"

payload = {
    "chatId": "79876543210@c.us",  
    "contact": {
     "phoneContact": "79001234567",
     "firstName": "Артём", 
     "middleName": "ΠŸΠ΅Ρ‚Ρ€ΠΎΠ²ΠΈΡ‡", 
     "lastName": "Евпаторийский", 
     "company": "ВСлосипСд"
    }
}

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, json=payload, headers=headers)

print(response.text.encode('utf8'))
curl --location '{{apiUrl}}/waInstance{{idInstance}}/sendContact/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chatId": "123456780910@c.us",
    "contact": {
        "phoneContact": 111111111111,
        "firstName": "АртСм",
        "middleName": "ΠŸΠ΅Ρ‚Ρ€ΠΎΠ²ΠΈΡ‡",
        "lastName": "Евпаторийский",
        "company": "ВСлосипСд"
    }
}'
var restTemplate = new RestTemplate();
var requestUrl = new StringBuilder();
requestUrl
    .append({{apiUrl}})
    .append("/waInstance").append({{idInstance}})
    .append("/sendContact/")
    .append({{apiTokenInstance}});

var headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);

var jsonBody = "{\r\n\t\"chatId\": \"79876543210@c.us\",\r\n\t\"contact\": {\r\n\t\t\"phoneContact\": 79001234567,\r\n    \t\"firstName\": \"АртСм\",\r\n\t\t\"middleName\": \"ΠŸΠ΅Ρ‚Ρ€ΠΎΠ²ΠΈΡ‡\",\r\n\t\t\"lastName\": \"Евпаторийский\",\r\n\t\t\"company\": \"ВСлосипСд\"\r\n\t}\r\n}\r\n";

var requestEntity = new HttpEntity<>(jsonBody, headers);

var response = restTemplate.exchange(requestUrl.toString(), HttpMethod.POST, requestEntity, String.class);
System.out.println(response);
var requestUrl = new StringBuilder();
requestUrl
    .append({{apiUrl}})
    .append("/waInstance").append({{idInstance}})
    .append("/sendContact/")
    .append({{apiTokenInstance}});

var response = Unirest.post(requestUrl.toString())
    .header("Content-Type", "application/json")
    .body("{\r\n\t\"chatId\": \"79876543210@c.us\",\r\n\t\"contact\": {\r\n\t\t\"phoneContact\": 79001234567,\r\n    \t\"firstName\": \"АртСм\",\r\n\t\t\"middleName\": \"ΠŸΠ΅Ρ‚Ρ€ΠΎΠ²ΠΈΡ‡\",\r\n\t\t\"lastName\": \"Евпаторийский\",\r\n\t\t\"company\": \"ВСлосипСд\"\r\n\t}\r\n}\r\n")
    .asString();

System.out.println(response);
Sub SendContact()
    Dim url As String
    Dim RequestBody As String
    Dim http As Object
    Dim response As String

    ' The apiUrl, idInstance and apiTokenInstance values are available in console, double brackets must be removed
    url = "{{apiUrl}}/waInstance{{idInstance}}/sendContact/{{apiTokenInstance}}"

    ' chatId - chat identifier, phoneContact - contact phone number in international format (without +) 11 or 12 digits, firstName - contact name, middleName - contact's middle name, lastName - contact's last name, company - contact's company name
    RequestBody = "{""chatId"":""71234567890@c.us"",""contact"":{""phoneContact"":70123456789,""firstName"":""АртСм"",""middleName"":""ΠŸΠ΅Ρ‚Ρ€ΠΎΠ²ΠΈΡ‡"",""lastName"":""Евпаторский"",""company"":""ВСлосипСд""}}"

    Set http = CreateObject("MSXML2.XMLHTTP")

    With http
        .Open "POST", url, False
        .setRequestHeader "Content-Type", "application/json"
        .send RequestBody
    End With

    response = http.responseText

    Debug.Print response

    ' Outputting the answer to the desired cell
    Range("A1").Value = response

    Set http = Nothing
End Sub