ملی پیامک مستندات وب‌سرویس پیامک
سفارش آنلاین
ملی پیامک مستندات وب‌سرویس پیامک
ملی پیامک مستندات وب‌سرویس پیامک

افزودن مناسبت مخاطب

آخرین به‌روزرسانی: 20 آبان 1405

آدرس وب سرویس

متد AddContactEvents

این متد یک مناسبت مانند تاریخ تولد را برای مخاطب موجود در دفترچه تلفن سامانه ثبت می‌کند.

پارامتر های ورودی

نام پارامترنوع پارامترتوضیحات
username String اجباری نام کاربری پنل پیامکی شما در سامانه
password String اجباری مقدار API Key شما در سامانه
contactId Int اجباری شناسۀ مخاطب در دفترچه تلفن
eventName String اجباری عنوان مناسبت (مانند تاریخ تولد)
eventType byte اجباری نوع مناسبت
eventDate dateTime اجباری تاریخ مناسب (به‌صورت میلادی)

مقدار بازگشتی

نام پارامترنوع پارامترتوضیحات
returnValue Int شناسۀ مناسبت ثبت‌شده را برمی‌گرداند.
0: مخاطبی با این شناسه یافت نشد.
1-: اطلاعات ورود نامعتبر است.

ثبت مناسب برای مخاطب از طریق URL:

https://api.payamak-panel.com/post/contacts.asmx/AddContactEvents?username=&password=&contactId=&eventName=&eventType=&eventDate=

AddContactEvents
PHP
PHPNodejsJavaC#PythonJavaEEgo
کد ورودیخروجی
$client = new SoapClient('https://api.payamak-panel.com/post/contacts.asmx?wsdl', ['encoding' => 'UTF-8', 'exceptions' => true]);
$params = [
    'username' => 'YOUR_USERNAME',
    'password' => 'YOUR_API_KEY',
    'contactId' => 123,
    'eventName' => 'تاریخ تولد',
    'eventType' => 1,
    'eventDate' => '2026-01-01T00:00:00',
];
$result = $client->__soapCall('AddContactEvents', [$params]);
var_dump($result);
import soap from "soap";
const [client] = await soap.createClientAsync("https://api.payamak-panel.com/post/contacts.asmx?wsdl");
const [result] = await client.AddContactEventsAsync({
  username: "YOUR_USERNAME",
  password: "YOUR_API_KEY",
  contactId: 123,
  eventName: "تاریخ تولد",
  eventType: 1,
  eventDate: "2026-01-01T00:00:00",
});
console.log(result);
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var requestBody = """

               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  
    
      YOUR_USERNAME
      YOUR_API_KEY
      123
      تاریخ تولد
      1
      2026-01-01T00:00:00
    
  

""";
var request = HttpRequest.newBuilder().uri(URI.create("https://api.payamak-panel.com/post/contacts.asmx"))
    .header("Content-Type", "text/xml; charset=utf-8")
    .header("SOAPAction", "\"http://tempuri.org/AddContactEvents\"")
    .POST(HttpRequest.BodyPublishers.ofString(requestBody)).build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
// Add https://api.payamak-panel.com/post/contacts.asmx?wsdl as a Connected Service before using the generated proxy.
var client = new ContactsSoapClient(ContactsSoapClient.EndpointConfiguration.ContactsSoap);
var request = new AddContactEventsRequest
{
    username = "YOUR_USERNAME",
    password = "YOUR_API_KEY",
    contactId = 123,
    eventName = "تاریخ تولد",
    eventType = 1,
    eventDate = "2026-01-01T00:00:00",
};
var result = await client.AddContactEventsAsync(request);
Console.WriteLine(result);
from zeep import Client
client = Client("https://api.payamak-panel.com/post/contacts.asmx?wsdl")
result = client.service.AddContactEvents(
    username="YOUR_USERNAME",
    password="YOUR_API_KEY",
    contactId=123,
    eventName="تاریخ تولد",
    eventType=1,
    eventDate="2026-01-01T00:00:00",
)
print(result)
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var requestBody = """

               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  
    
      YOUR_USERNAME
      YOUR_API_KEY
      123
      تاریخ تولد
      1
      2026-01-01T00:00:00
    
  

""";
var request = HttpRequest.newBuilder().uri(URI.create("https://api.payamak-panel.com/post/contacts.asmx"))
    .header("Content-Type", "text/xml; charset=utf-8")
    .header("SOAPAction", "\"http://tempuri.org/AddContactEvents\"")
    .POST(HttpRequest.BodyPublishers.ofString(requestBody)).build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
package main
import ("fmt"; "io"; "net/http"; "strings")
func main() {
  requestBody := `
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  
    
      YOUR_USERNAME
      YOUR_API_KEY
      123
      تاریخ تولد
      1
      2026-01-01T00:00:00
    
  
`
  request, err := http.NewRequest(http.MethodPost, "https://api.payamak-panel.com/post/contacts.asmx", strings.NewReader(requestBody)); if err != nil { panic(err) }
  request.Header.Set("Content-Type", "text/xml; charset=utf-8")
  request.Header.Set("SOAPAction", "\"http://tempuri.org/AddContactEvents\"")
  response, err := http.DefaultClient.Do(request); if err != nil { panic(err) }; defer response.Body.Close()
  body, err := io.ReadAll(response.Body); if err != nil { panic(err) }; fmt.Println(string(body))
}
//SOAP پاسخ موفق

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <AddContactEventsResponse xmlns="http://tempuri.org/">
      <AddContactEventsResult>42</AddContactEventsResult>
    </AddContactEventsResponse>
  </soap:Body>
</soap:Envelope>

//SOAP خطای کاربردی

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <AddContactEventsResponse xmlns="http://tempuri.org/">
      <AddContactEventsResult>-1</AddContactEventsResult>
    </AddContactEventsResponse>
  </soap:Body>
</soap:Envelope>