SendList Web Service

Service URL	sendlist.asmx

SendList web servisini kullanarak, toplu veri aktarımı, gönderim listesi yaratabilir veya mevcut gönderim listelerini hesabınızdan silebilirsiniz.

SendList web servisine ait aşağıda ki metodlar bulunmaktadır.

Method	Description
AddBulk	Bulk adds to a Send List.
AddBulkFile	Bulk adds to a Send List via File Upload.
CreateSendList	Creates a Send List.
QuerySendListMemberCount	Returns Member Count in a given Send List.
RemoveBulkFile	Bulk removes from a Send List or deletes members via File Upload.
RemoveSendList	Removes a Send List.

Hesabınızdan üye silerken dikkatli olmanız gerekir. 2015 Mayıs ayında çıkan yasa gereği, üye geçmiş bilgilerini en az 1 yıl saklamanız gerekmektedir.

Geliştiricinin her hangi bir web servis ile etkileşime geçebilmesi için, öncelikle Login metodunu kullanarak bir SERVICE TICKET alması gerekir. Diğer web servis ve metodlarına yaratmış olduğu bu değer ile istekte bulunabilir.

CreateSendList

<CreateSendList>
Boş bir gönderim listesi yaratır.

Parametreler

Parametre	Değer
ServiceTicket	`Login` aksiyonu ile elde edilen `ServiceTicket`	MANDATORY
ListGroup	Listenin grup adı.	MANDATORY
ListName	Listenin adı.	MANDATORY

ORNEK REQUEST

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <CreateSendList xmlns="http://ws.euromsg.com/sendlist">
            <ServiceTicket>string</ServiceTicket>
            <ListGroup>string</ListGroup>
            <ListName>string</ListName>
        </CreateSendList>
    </soap:Body>
</soap:Envelope>

ORNEK RESPONSE

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <CreateSendListResponse xmlns="http://ws.euromsg.com/sendlist">
            <CreateSendListResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
                <CreatedListID>1686794</CreatedListID>
            </CreateSendListResult>
        </CreateSendListResponse>
    </soap:Body>
</soap:Envelope>

Başarılı istek durumunda <CODE> parametresi 00 olarak cevap döner. Buna ek olarak yaratılan liste ID’si CREATEDLISTID döner.

Hata Parametreleri

Code	Message	DetailedMessage	Açıklama
9998	No session. Please try re-logon.		`Login` metodu çalıştırılmamış. Aktif oturum yok.

AddBulk

<AddBulk>
Toplu bir şekilde üye eklemeye olanak verir.

Parametreler

Parametre	Değer
ServiceTicket	`Login` aksiyonu ile elde edilen `ServiceTicket`	MANDATORY
ListGroup	Eklenecek listenin grup adı.	MANDATORY
ListName	Listenin adı.	MANDATORY
Key	Referans Key Adı. Bu alana göre üye ekleme veya güncelleme yapılacaktır. Referans Key’in değerini `DemograficData` alanında belirtilmesi gerekir.	MANDATORY
DemograficData	`ArrayOfEmKeyValue` dizisi ile üyeye ait alanlar belirlenir.	MANDATORY
ForceInsert	Üye sistemde var ise, `true` değeri gönderilmesi durumunda, varolan üye güncellenir.	MANDATORY

Ad, Soyad gibi alanlar Related Marketing Cloud platformu üzerinden ayarlanır.

Statik Alanlar

Alan Adı	Açıklama
EMAIL	Email adresi
STATUS	Üye durumu. A : Aktif, P : Pasif
EMAIL_PERMIT	Email izin durumu. Y : Evet, N : Hayır
GSM_PERMIT	SMS izin durumu. Y : Evet, N : Hayır
FAX_PERMIT	FAX izin durumu. Y : Evet, N : Hayır
CALL_PERMIT	Call Center izin durumu. Y : Evet, N : Hayır
PRINT_PERMIT	Print izin durumu. Y : Evet, N : Hayır
REFERRAL	Referans adresi
REFERRAL_DOMAIN	Referans domain

ORNEK REQUEST

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <AddBulk
            xmlns="http://ws.euromsg.com/sendlist">
            <ServiceTicket>string</ServiceTicket>
            <ListGroup>string</ListGroup>
            <ListName>string</ListName>
            <Key>string</Key>
            <DemograficData>
                <ArrayOfEmKeyValue>
                    <EmKeyValue>
                        <Key>string</Key>
                        <Value>string</Value>
                    </EmKeyValue>
                    <EmKeyValue>
                        <Key>string</Key>
                        <Value>string</Value>
                    </EmKeyValue>
                </ArrayOfEmKeyValue>
                <ArrayOfEmKeyValue>
                    <EmKeyValue>
                        <Key>string</Key>
                        <Value>string</Value>
                    </EmKeyValue>
                    <EmKeyValue>
                        <Key>string</Key>
                        <Value>string</Value>
                    </EmKeyValue>
                </ArrayOfEmKeyValue>
            </DemograficData>
            <ForceInsert>boolean</ForceInsert>
        </AddBulk>
    </soap:Body>
</soap:Envelope>

ORNEK RESPONSE

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <AddBulkResponse
            xmlns="http://ws.euromsg.com/sendlist">
            <AddBulkResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
                <CreatedListID>0</CreatedListID>
            </AddBulkResult>
            <DetailsResult>
                <BulkDetailedResult>
                    <Key>test1@sampledomain.com</Key>
                    <Code>00</Code>
                    <Message />
                    <DetailedMessage />
                </BulkDetailedResult>
                <BulkDetailedResult>
                    <Key>test2@sampledomain.com</Key>
                    <Code>00</Code>
                    <Message />
                    <DetailedMessage />
                </BulkDetailedResult>
            </DetailsResult>
        </AddBulkResponse>
    </soap:Body>
</soap:Envelope>

Başarılı istek durumunda <CODE> parametresi 00 olarak cevap döner.

Hata Parametreleri

Code	Message	Açıklama
9998	No session. Please try re-logon.	`Login` metodu çalıştırılmamış. Aktif oturum yok.
99	No such list!	Belirtilen liste bulunamadı.
99	Member is new. No update!	`ForceInsert` `false` ise ve kullanıcı sistemde yer almıyorsa alınan hatadır. Üye eklenmemiştir. Yeni üyeyi sistem eklemek için `ForceInsert`parametresinin değeri `true` olmalıdır.

AddBulkFile

<AddBulkFile>
Bir dosyada yer alan üyelerin toplu olarak Related Marketing Cloud hesabınıza yüklenmesini sağlar.

Parametreler

Parametre	Değer
ServiceTicket	`Login` aksiyonu ile elde edilen `ServiceTicket`	MANDATORY
ListGroup	Eklenecek listenin grup adı.	MANDATORY
ListName	Listenin adı.	MANDATORY
Key	Referans Key Adı. Bu alana göre üye ekleme veya güncelleme yapılacaktır.	MANDATORY
Map	Dosyada ki alanların sistem alanları ile eşleştirilmesini yapar. Örn. EMAIL=email;COLUMN1=NameSurname;COLUMN2=KeyID.	MANDATORY
File	Yüklenecek dosya.	MANDATORY
FileType	Dosya türü. `zip` veya `csv` olmalı.	MANDATORY
NotificationEmail	Yükleme işlemi bittiğinde, burada belirtilen email adresine bilgilendirme emaili gönderilir.	MANDATORY

ORNEK REQUEST

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <AddBulkFile
            xmlns="http://ws.euromsg.com/sendlist">
            <ServiceTicket>string</ServiceTicket>
            <ListGroup>string</ListGroup>
            <ListName>string</ListName>
            <Key>string</Key>
            <Map>string</Map>
            <File>base64Binary</File>
            <FileType>string</FileType>
            <NotificationEmail>string</NotificationEmail>
        </AddBulkFile>
    </soap:Body>
</soap:Envelope>

ORNEK RESPONSE

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soap:Body>
        <AddBulkFileResponse
            xmlns="http://ws.euromsg.com/sendlist">
            <AddBulkFileResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
                <ConversationID>EEFF123AE537442BBF9AD3231F812684</ConversationID>
                <CreatedListID>0</CreatedListID>
            </AddBulkFileResult>
        </AddBulkFileResponse>
    </soap:Body>
</soap:Envelope>

Başarılı istek durumunda <CODE> parametresi 00 olarak cevap döner. Buna ek olarak yaratılan liste ID’si CREATEDLISTID döner.

Hata Parametreleri

Code	Message	DetailedMessage	Açıklama
9998	No session. Please try re-logon.		`Login` metodu çalıştırılmamış. Aktif oturum yok.
99	Not a valid file type. It must be ZIP or CSV or TXT.

QuerySendListMemberCount

<QuerySendListMemberCount>
Gönderim listesindeki kişi sayısını gösterir.