AddContact#
ΠΠ΅ΡΠΎΠ΄ ΠΏΡΠ΅Π΄Π½Π°Π·Π½Π°ΡΠ΅Π½ Π΄Π»Ρ Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ΠΈΡ Π½ΠΎΠΌΠ΅ΡΠ° Π² ΠΊΠΎΠ½ΡΠ°ΠΊΡΡ.
ΠΠ΅ΡΠ°-Π²Π΅ΡΡΠΈΡ
Π€ΡΠ½ΠΊΡΠΈΠΎΠ½Π°Π»ΡΠ½ΠΎΡΡΡ Π½Π°Ρ ΠΎΠ΄ΠΈΡΡΡ Π² ΡΠ΅ΠΆΠΈΠΌΠ΅ Π±Π΅ΡΠ°-Π²Π΅ΡΡΠΈΠΈ. Π€ΡΠ½ΠΊΡΠΈΠΈ ΠΌΠΎΠ³ΡΡ Π±ΡΡΡ ΠΈΠ·ΠΌΠ΅Π½Π΅Π½Ρ, Π° ΡΠ°ΠΊΠΆΠ΅ ΠΌΠΎΠ³ΡΡ ΡΠ°Π±ΠΎΡΠ°ΡΡ Π½Π΅ΡΡΠ°Π±ΠΈΠ»ΡΠ½ΠΎ.
ΠΠ°ΠΏΡΠΎΡ#
ΠΠ»Ρ Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ΠΈΡ Π½ΠΎΠΌΠ΅ΡΠ° Π² ΠΊΠΎΠ½ΡΠ°ΠΊΡΡ ΡΡΠ΅Π±ΡΠ΅ΡΡΡ Π²ΡΠΏΠΎΠ»Π½ΠΈΡΡ Π·Π°ΠΏΡΠΎΡ ΠΏΠΎ Π°Π΄ΡΠ΅ΡΡ:
{{apiUrl}}/waInstance{{idInstance}}/addContact/{{apiTokenInstance}}
ΠΠ»Ρ ΠΏΠΎΠ»ΡΡΠ΅Π½ΠΈΡ ΠΏΠ°ΡΠ°ΠΌΠ΅ΡΡΠΎΠ² Π·Π°ΠΏΡΠΎΡΠ° apiUrl, idInstance ΠΈ apiTokenInstance ΠΎΠ±ΡΠ°ΡΠΈΡΠ΅ΡΡ ΠΊ ΡΠ°Π·Π΄Π΅Π»Ρ ΠΠ΅ΡΠ΅Π΄ Π½Π°ΡΠ°Π»ΠΎΠΌ ΡΠ°Π±ΠΎΡΡ.
ΠΠ°ΡΠ°ΠΌΠ΅ΡΡΡ Π·Π°ΠΏΡΠΎΡΠ°#
| ΠΠ°ΡΠ°ΠΌΠ΅ΡΡ | Π’ΠΈΠΏ | ΠΠ±ΡΠ·Π°ΡΠ΅Π»ΡΠ½ΡΠΉ | ΠΠ½Π°ΡΠ΅Π½ΠΈΠ΅ ΠΏΠΎ ΡΠΌΠΎΠ»ΡΠ°Π½ΠΈΡ | ΠΠΏΠΈΡΠ°Π½ΠΈΠ΅ |
|---|---|---|---|---|
chatId | string | ΠΠ° | - | ΠΠΎΠΌΠ΅Ρ ΡΠ΅Π»Π΅ΡΠΎΠ½Π° Π² ΡΠΎΡΠΌΠ°ΡΠ΅ ΠΈΠ΄Π΅Π½ΡΠΈΡΠΈΠΊΠ°ΡΠΎΡΠ° Π»ΠΈΡΠ½ΠΎΠ³ΠΎ ΡΠ°ΡΠ°. ΠΠ°ΠΏΡΠΈΠΌΠ΅Ρ "79876543210@c.us" |
firstName | string | ΠΠ° | - | ΠΠΌΡ ΠΊΠΎΠ½ΡΠ°ΠΊΡΠ° |
lastName | string | ΠΠ΅Ρ | - | Π€Π°ΠΌΠΈΠ»ΠΈΡ ΠΊΠΎΠ½ΡΠ°ΠΊΡΠ° |
saveInAddressbook | boolean | ΠΠ΅Ρ | true | Π€Π»Π°Π³ ΡΠΎΡ ΡΠ°Π½ΡΡΡ Π»ΠΈ ΠΊΠΎΠ½ΡΠ°ΠΊΡ Π² ΡΠ΅Π»Π΅ΡΠΎΠ½Π½ΠΎΠΉ ΠΊΠ½ΠΈΠ³Π΅ Π½Π° ΠΎΡΠ½ΠΎΠ²Π½ΠΎΠΌ ΡΡΡΡΠΎΠΉΡΡΠ²Π΅ |
ΠΡΠΈΠΌΠ΅Ρ ΡΠ΅Π»Π° Π·Π°ΠΏΡΠΎΡΠ°#
{
"chatId": "79876543210@c.us",
"firstName": "ΠΠ²Π°Π½",
"lastName": "Π¦Π°ΡΠ΅Π²ΠΈΡ",
"saveInAddressbook": true
}
ΠΡΠ²Π΅Ρ#
ΠΠΎΠ»Ρ ΠΎΡΠ²Π΅ΡΠ°#
| ΠΠΎΠ»Π΅ | Π’ΠΈΠΏ | ΠΠΏΠΈΡΠ°Π½ΠΈΠ΅ |
|---|---|---|
addContact | boolean | ΠΠΎΠ·Π²ΡΠ°ΡΠ°Π΅Ρ True, Π΅ΡΠ»ΠΈ ΠΌΠ΅ΡΠΎΠ΄ Π²ΡΠΏΠΎΠ»Π½Π΅Π½ Π±Π΅Π· ΠΎΡΠΈΠ±ΠΎΠΊ. ΠΡΡΡΡΡΠ²ΡΠ΅Ρ Π² ΠΎΡΠ²Π΅ΡΠ΅ ΡΠ΅Π»Π° Ρ ΠΎΡΠΈΠ±ΠΊΠΎΠΉ. |
messsage | string | ΠΠΏΠΈΡΠ°Π½ΠΈΠ΅ ΠΎΡΠΈΠ±ΠΊΠΈ, Π΅ΡΠ»ΠΈ ΠΌΠ΅ΡΠΎΠ΄ Π²ΡΠΏΠΎΠ»Π½Π΅Π½ Ρ ΠΎΡΠΈΠ±ΠΊΠΎΠΉ. ΠΡΡΡΡΡΡΠ²ΡΠ΅Ρ Π² ΠΎΡΠ²Π΅ΡΠ΅ ΡΠ΅Π»Π° Π±Π΅Π· ΠΎΡΠΈΠ±ΠΊΠΈ. |
ΠΡΠΈΠΌΠ΅Ρ ΡΠ΅Π»Π° ΠΎΡΠ²Π΅ΡΠ°#
{
"addContact": true
}
ΠΡΠΏΠΎΠ»Π½Π΅Π½ΠΈΠ΅ ΠΌΠ΅ΡΠΎΠ΄Π° Ρ ΠΎΡΠΈΠ±ΠΊΠΎΠΉ#
status code 400 Bad request
{
"message": "Contact 77059640505@c.us already exists"
}
status code 404 Not found
{
"message": "77059640505@c.us is not on WhatsApp"
}
ΠΡΠΈΠ±ΠΊΠΈ AddContact#
ΠΠ΅ΡΠ΅ΡΠ΅Π½Ρ ΠΎΠ±ΡΠΈΡ Π΄Π»Ρ Π²ΡΠ΅Ρ ΠΌΠ΅ΡΠΎΠ΄ΠΎΠ² ΠΎΡΠΈΠ±ΠΎΠΊ ΡΠΌΠΎΡΡΠΈΡΠ΅ Π² ΡΠ°Π·Π΄Π΅Π»Π΅ Π‘ΡΠ°Π½Π΄Π°ΡΡΠ½ΡΠ΅ ΠΎΡΠΈΠ±ΠΊΠΈ
| ΠΠΎΠ΄ HTTP | ΠΠ΄Π΅Π½ΡΠΈΡΠΈΠΊΠ°ΡΠΎΡ ΠΎΡΠΈΠ±ΠΊΠΈ | ΠΠΏΠΈΡΠ°Π½ΠΈΠ΅ |
|---|---|---|
| 400 | Bad Request Contact 79876543210@c.us already exists | ΠΠΎΠ½ΡΠ°ΠΊΡ Ρ ΡΡΠΈΠΌ Π½ΠΎΠΌΠ΅ΡΠΎΠΌ ΡΠΆΠ΅ Π΅ΡΡΡ Π² ΡΠ΅Π»Π΅ΡΠΎΠ½Π½ΠΎΠΉ ΠΊΠ½ΠΈΠ³Π΅ |
| 404 | Not found 79876543210@c.us is not on WhatsApp | ΠΠΎΠ½ΡΠ°ΠΊΡ Ρ ΡΡΠΈΠΌ Π½ΠΎΠΌΠ΅ΡΠΎΠΌ ΠΎΡΡΡΡΡΡΠ²ΡΠ΅Ρ Π² WhatsApp |
ΠΡΠΈΠΌΠ΅ΡΡ ΠΊΠΎΠ΄Π°#
import requests
url = "{{apiUrl}}/waInstance{{idInstance}}/addContact/{{apiTokenInstance}}"
payload = {
"chatId": "79876543210@c.us",
"firstName": "ΠΠ²Π°Π½",
"lastName": "Π¦Π°ΡΠ΅Π²ΠΈΡ",
"saveInAddressbook": true
}
headers = {
'Content-Type': 'application/json'
}
response = requests.post(url, json=payload, headers=headers)
print(response.text.encode('utf8'))
<?php
//The apiUrl, idInstance and apiTokenInstance values are available in console, double brackets must be removed
$url = '{{apiUrl}}/waInstance{{idInstance}}/addContact/{{apiTokenInstance}}';
//chatId is the number (@c.us)
$data = array(
'chatId' => '71234567890@c.us',
'firstName' => 'ΠΠ²Π°Π½',
'lastName' => 'Π¦Π°ΡΠ΅Π²ΠΈΡ',
'saveInAddressbook' => 'true',
);
$options = array(
'http' => array(
'header' => "Content-Type: application/json\r\n",
'method' => 'POST',
'content' => json_encode($data)
)
);
$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
echo $response;
?>
curl --location '{{apiUrl}}/waInstance{{idInstance}}/addContact/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"chatId": "71234567890@c.us",
"firstName": "ΠΠ²Π°Π½",
"lastName": "Π¦Π°ΡΠ΅Π²ΠΈΡ",
"saveInAddressbook": true
}'
Sub AddContact()
Dim URL As String
Dim RequestBody As String
Dim http As Object
' The apiUrl, idInstance and apiTokenInstance values are available in console, double brackets must be removed
URL = "{{apiUrl}}/waInstance{{idInstance}}/addContact/{{apiTokenInstance}}"
' chatId is the number (@c.us)
RequestBody = "{""chatId"":""71234567890@c.us"",""firstName"":""ΠΠ²Π°Π½"", ""lastName"":""Π¦Π°ΡΠ΅Π²ΠΈΡ"", ""saveInAddressbook"":""true""}"
Set http = CreateObject("MSXML2.XMLHTTP")
With http
.Open "POST", URL, False
.setRequestHeader "Content-Type", "application/json"
.send RequestBody
End With
Set http = Nothing
End Sub
program addContact;
{$APPTYPE CONSOLE}
uses
System.SysUtils,
System.Classes, System.Net.HttpClient, System.Net.URLClient, System.Net.HttpClientComponent;
var
HttpClient: TNetHTTPClient;
RequestBody: TStringStream;
RequestHeaders: TNetHeaders;
Response: IHTTPResponse;
EndpointURL, ID_INSTANCE, API_TOKEN_INSTANCE: string;
begin
ID_INSTANCE := '110100001';
API_TOKEN_INSTANCE := 'd75b3a66374942c5b3c019c698abc2067e151558acbd451234';
EndpointURL := 'https://api.green-api.com/waInstance' + ID_INSTANCE + '/addContact/' + API_TOKEN_INSTANCE;
HttpClient := TNetHTTPClient.Create(nil);
RequestBody := TStringStream.Create('{ "chatId": "79876543210@c.us", "firstName": "ΠΠ²Π°Π½", "lastName": "Π¦Π°ΡΠ΅Π²ΠΈΡ", "saveInAddressbook": true }', TEncoding.UTF8);
RequestHeaders := [
TNetHeader.Create('Content-Type', 'application/json')
];
try
Response := HTTPClient.Post(EndpointURL, RequestBody, nil, RequestHeaders);
if Response.StatusCode = 200 then
Writeln('[Response]: ' + Response.ContentAsString)
else
Writeln('[ERROR ' + IntToStr(Response.StatusCode) + ']:' + Response.StatusText + '' + Response.ContentAsString);
readln;
except
on E: Exception do
Writeln(E.ClassName, ': ', E.Message);
end;
HttpClient.Free;
RequestBody.Free;
end.