SendList Web Service

POST

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

Back to Top ^

<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

Back to Top ^

<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

Back to Top ^

<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

Back to Top ^

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

Parametreler

Parametre	Değer
ServiceTicket	`Login` aksiyonu ile elde edilen `ServiceTicket`	MANDATORY
ListID	Liste ID	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>
        <QuerySendListMemberCount
            xmlns="http://ws.euromsg.com/sendlist">
            <ServiceTicket>string</ServiceTicket>
            <ListID>int</ListID>
        </QuerySendListMemberCount>
    </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>
        <QuerySendListMemberCountResponse xmlns="http://ws.euromsg.com/sendlist">
            <QuerySendListMemberCountResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
                <CreatedListID>0</CreatedListID>
            </QuerySendListMemberCountResult>
            <MemberCount>0</MemberCount>
        </QuerySendListMemberCountResponse>
    </soap:Body>
</soap:Envelope>

Başarılı istek durumunda <CODE> parametresi 00 olarak cevap 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.

RemoveBulkFile

Back to Top ^

<RemoveBulkFile>
Bir dosyada yer alan üyelerin seçilerek Related Marketing Cloud hesabınızdan silinmesini sağlar.

Parametreler

Parametre	Değer
ServiceTicket	`Login` aksiyonu ile elde edilen `ServiceTicket`	MANDATORY
ListGroup	Liste grup adı.	MANDATORY
ListName	Listenin adı.	MANDATORY
Key	Referans Key Adı.	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
DeleteIfInNoList	Eğer üye hiç bir listede yer almıyorsa, `true` gönderilmesi durumunda, kullanıcıyı tamamen siler.	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>
        <RemoveBulkFile 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>
            <DeleteIfInNoList>boolean</DeleteIfInNoList>
        </RemoveBulkFile>
    </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>
        <RemoveBulkFileResponse xmlns="http://ws.euromsg.com/sendlist">
            <RemoveBulkFileResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
                <ConversationID>EEFF123AE537442BBF9AD3231F812684</ConversationID>
                <CreatedListID>0</CreatedListID>
            </RemoveBulkFileResult>
        </RemoveBulkFileResponse >
    </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.

RemoveSendList

Back to Top ^

<RemoveSendList>
Bir gönderim listesini siler.

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>
        <RemoveSendList xmlns="http://ws.euromsg.com/sendlist">
            <ServiceTicket>string</ServiceTicket>
            <ListGroup>string</ListGroup>
            <ListName>string</ListName>
        </RemoveSendList>
    </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>
        <RemoveSendListResponse
            xmlns="http://ws.euromsg.com/sendlist">
            <RemoveSendListResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
                <CreatedListID>0</CreatedListID>
            </RemoveSendListResult>
        </RemoveSendListResponse>
    </soap:Body>
</soap:Envelope>

Başarılı istek durumunda <CODE> parametresi 00 olarak cevap döner. Bunun dışında dönen 99 değerleri hata belirtir.

Hata Parametreleri

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