Mesajı yanıtla

Pazaryerindeki bir alıcı sorusunu yanıtlar ve yanıtı StockMount'a gönderilen mesaj olarak kaydeder.

POST https://out.stockmount.com/api/Integration/SendUserMessage

Veri değiştirir

Desteklenen entegrasyon N11'dir (IntegrationId 2). Yalnızca var olan bir ürün sorusu yanıtlanabilir; yeni bir yazışma başlatılamaz. Yanıtlanacak sorunun Code değerini UserMessageCode alanında gönderin; bu değer sayısal olmalıdır.

Gönderimden sonra yanıt, gönderilen mesaj (tip 2) olarak kaydedilir ve kodu {soruKodu}_ANSWER_{n} biçimini alır. Yanıtlanan soru kapatılır.

SetMessageRead true ise UserMessageId ile belirtilen soru ayrıca okundu olarak işaretlenir.

Subject ve From alanlarını da gönderin. Bu alanlar eksikse yanıt N11'e iletilebilir ama StockMount'a kaydedilemez ve 99999 döner; bu durumda isteği tekrarlamadan önce N11'de yanıtı kontrol edin.

Başarılı yanıt, N11'in yanıtı kabul ettiğini garanti etmez: N11 isteği başlatılır ancak N11'in sonucu beklenmez. N11 tarafındaki hatalar bu uç noktaya yansımaz.

IntegrationId için 1 ve 2 dışındaki değerler 99999 döndürür ve ErrorMessage boş gelir. Başarılı yanıtta Response alanı gelmez.

İstek alanları

Alan	Tip	Açıklama
`ApiCode` zorunlu	string	`DoLogin` yanıtından aldığınız oturum kodu.
`StoreId` zorunlu	integer	Sorunun ait olduğu mağazanın kimliği.
`IntegrationId` zorunlu	integer	Mağazanın entegrasyon kimliği. N11 için 2.
`UserMessageCode` zorunlu	string	Yanıtlanacak sorunun `Code` değeri (N11 soru kimliği, sayısal). N11 için zorunludur.
`Message` zorunlu	string	Yanıt metni.
`To` zorunlu	string	Alıcının kullanıcı adı (sorudaki `From` değeri). Kayıtta alıcı olarak saklanır.
`From`	string	Gönderen olarak kaydedilecek değer (ör. mağaza adınız). Gönderilmezse kayıt başarısız olur.
`Subject`	string	Kaydedilecek konu (ör. sorunun `Subject` değeri). Gönderilmezse kayıt başarısız olur.
`SetMessageRead`	boolean	İsteğe bağlı. `true` ise soru ayrıca okundu işaretlenir. Varsayılan `false`.
`UserMessageId`	integer	Yanıtlanan sorunun `UserMessageId` değeri. `SetMessageRead` `true` ise kullanılır.

Yanıt alanları (Response)

Başarılı çağrıda Response alanı boş döner; sonucu Result alanından okuyun.

Bu servisin hata kodları

Kod	Ne zaman
`10001`	`StoreId` hesabınıza ait bir mağaza değil (`ErrorMessage`: `Invalid store.`).
`00003`	Zorunlu alan eksik. `ErrorMessage`: `StoreId`, `IntegrationId`, `Message`, `To` veya N11 için `UserMessageCode` boşsa `MessageCode`.
`99999`	`IntegrationId` desteklenmiyor (`ErrorMessage` boş), mağazanın N11 API bilgileri yok (`ErrorMessage` boş), `UserMessageCode` sayısal değil, yanıt StockMount'a kaydedilemedi veya sunucu hatası oluştu.

Oturum hataları (00001, 00006) ve tüm kodlar için hata kodları.

İlgili servisler

Örnek istek

{
  "ApiCode": "API_CODE",
  "StoreId": 1234,
  "IntegrationId": 2,
  "UserMessageCode": "301245678",
  "UserMessageId": 88119,
  "To": "alici_123",
  "From": "ornekmagaza",
  "Subject": "Ürün sorusu",
  "Message": "Merhaba, ürün stoktadır.",
  "SetMessageRead": true
}

curl -X POST 'https://out.stockmount.com/api/Integration/SendUserMessage' \
  -H 'Content-Type: application/json' \
  -d '{
  "ApiCode": "API_CODE",
  "StoreId": 1234,
  "IntegrationId": 2,
  "UserMessageCode": "301245678",
  "UserMessageId": 88119,
  "To": "alici_123",
  "From": "ornekmagaza",
  "Subject": "Ürün sorusu",
  "Message": "Merhaba, ürün stoktadır.",
  "SetMessageRead": true
}'

using System.Net.Http;
using System.Text;

using var http = new HttpClient();
var json = """
{
  "ApiCode": "API_CODE",
  "StoreId": 1234,
  "IntegrationId": 2,
  "UserMessageCode": "301245678",
  "UserMessageId": 88119,
  "To": "alici_123",
  "From": "ornekmagaza",
  "Subject": "Ürün sorusu",
  "Message": "Merhaba, ürün stoktadır.",
  "SetMessageRead": true
}
""";

var response = await http.PostAsync(
    "https://out.stockmount.com/api/Integration/SendUserMessage",
    new StringContent(json, Encoding.UTF8, "application/json"));

var result = await response.Content.ReadAsStringAsync();
// Result == false ise ErrorCode ve ErrorMessage alanlarına bakın.
Console.WriteLine(result);

<?php
$body = <<<'JSON'
{
  "ApiCode": "API_CODE",
  "StoreId": 1234,
  "IntegrationId": 2,
  "UserMessageCode": "301245678",
  "UserMessageId": 88119,
  "To": "alici_123",
  "From": "ornekmagaza",
  "Subject": "Ürün sorusu",
  "Message": "Merhaba, ürün stoktadır.",
  "SetMessageRead": true
}
JSON;

$ch = curl_init('https://out.stockmount.com/api/Integration/SendUserMessage');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if (!$result['Result']) {
    echo $result['ErrorCode'] . ' ' . $result['ErrorMessage'];
}

import requests

payload = {
    "ApiCode": "API_CODE",
    "StoreId": 1234,
    "IntegrationId": 2,
    "UserMessageCode": "301245678",
    "UserMessageId": 88119,
    "To": "alici_123",
    "From": "ornekmagaza",
    "Subject": "\u00DCr\u00FCn sorusu",
    "Message": "Merhaba, \u00FCr\u00FCn stoktad\u0131r.",
    "SetMessageRead": True
}

response = requests.post("https://out.stockmount.com/api/Integration/SendUserMessage", json=payload, timeout=60)
result = response.json()

if not result["Result"]:
    print(result["ErrorCode"], result["ErrorMessage"])

const payload = {
  "ApiCode": "API_CODE",
  "StoreId": 1234,
  "IntegrationId": 2,
  "UserMessageCode": "301245678",
  "UserMessageId": 88119,
  "To": "alici_123",
  "From": "ornekmagaza",
  "Subject": "Ürün sorusu",
  "Message": "Merhaba, ürün stoktadır.",
  "SetMessageRead": true
};

const response = await fetch("https://out.stockmount.com/api/Integration/SendUserMessage", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(payload),
});
const result = await response.json();

if (!result.Result) {
  console.error(result.ErrorCode, result.ErrorMessage);
}

Örnek yanıt

{
  "Result": true
}

Deneyin

İstek tarayıcınızdan doğrudan out.stockmount.com adresine gider. ApiCode bu sitede saklanmaz; yalnızca bu sekme açıkken tutulur.

İstek göndermek için önce ApiCode alın.

Bu servis hesabınızdaki gerçek verileri değiştirir.

Gövde (JSON)

{
  "ApiCode": "{{apiCode}}",
  "StoreId": 1234,
  "IntegrationId": 2,
  "UserMessageCode": "301245678",
  "UserMessageId": 88119,
  "To": "alici_123",
  "From": "ornekmagaza",
  "Subject": "Ürün sorusu",
  "Message": "Merhaba, ürün stoktadır.",
  "SetMessageRead": true
}

Bu isteğin hesabımdaki gerçek verileri değiştireceğini biliyorum.