Hi
@Hiren Shah,
Ok, I got your point now. I see that there is a 1 to many relation between
CommunicationMessage &
Receiver
in the resource model of Communications API Specification document, but what I did not find was LoVs of
status field in TMF681B_Communication_API_Conformance_Profile_R18.0.1.docx or Rest API Swagger (
https://github.com/tmforum-apis/TMF681_Communication). In my view the relationship denotes to handle the case of bulk notification i.e. same message to many customers in one go.
I think the problem is similar in nature to that discussed in thread that I have referred to in my previous comment; like it is difficult to manage fault & retry mechanism in multi-channel case, the same applies here also. There are two options that I can think of:
1. We can make the relationship between
CommunicationMessage &
Receiver as 1:1 and consider that notification generating/originating systems will send multiple notifications for each end receiver
2. Or we can introduce a status field to receiver resource which will keep track of status of message sent to each receiver along with defining our own LoVs for status at
CommunicationMessage resource level
like "Partially Completed" if one of the messages to receiver fails, "Failed" if all of them fail.
@Abdeljalil Abataleb ,
@Knut Johannessen,
@Hugo Vaughan any thoughts on this ?
------------------------------
Rabinder Devnani
Sterlite Technologies Limited
------------------------------
Original Message:
Sent: Nov 15, 2019 03:43
From: Hiren Shah
Subject: Communication API REST Specification Status for the multiple receivers
Hi @Rabinder Devnani,
Thanks for the update!!.
My query is regarding single Chanel notification to multiple receivers. Consider following API request for sending email notification to 2 individuals ( John Doe & James Smith):
{ "id":"1001", "href":"http://serverlocation:port/communicationMessage/v1/communicationMessage/5 6445633245", "type":"1", "priority":"1", "subject":"News: the latest promotion for you", "sendTime":"2016-12-19 T04:00:00.0Z", "sendTimeComplete":"2016-12-19 T05:00:00.0Z", "status":"Completed", "description":"this is communication message for promotion", "content":"Dear $Parameter1, Here is the information of the promotion $Parameter2", "contactLogFlag":"false", "callbackFlag":"true", "tryTimes":"3", "version":"0.1", "characteristic":[ { "name":"$Parameter1", "value":"Mr. Bush" }, { "name":"$Parameter2", "value":"4G_LTE Discount 30%" } ], "attachment":[ { "path":"/attachedfile/1, /attachedfile/", "name":"File_XYZ_001" } ], " sender":{ "id":"10099", "name":"ABC Company", "phoneNumber":"10086" }, "receiver":[ { "id":"10234", "name":"Customer", "phoneNumber":"008613811112222", "email":"john@xyz.com", "relatedParty":{ "id":"991", "href":"http://serverlocation:port/partyManagement/individual/1", "role":"customer", "name":"John Doe" } }, { "id":"10235", "name":"Customer2", "email":"james@xyz.com", "phoneNumber":"008613811112233", "relatedParty":{ "id":"991", "href":"http://serverlocation:port/partyManagement/individual/2", "role":"customer", "name":"James Smith" } } ]}
Now, what should be status of notification, when notification is successfully send to James but fails for John?
------------------------------
Hiren Shah
Sterlite Technologies Limited
Original Message:
Sent: Nov 14, 2019 06:00
From: Rabinder Devnani
Subject: Communication API REST Specification Status for the multiple receivers
Hi @Hiren Shah,
The issue is being discussed in following thread posted by @Jay Vaishnav. Currently the API supports sending the message to single channel only (message receiver in your terminology). Problems of sending the message to multiple channels in single API is discussed in the following thread.
If you are referring to "register listener" method of the API, then it is completely different from multiple channel.
Please continue your comments on below thread.
https://engage.tmforum.org/communities/community-home/digestviewer/viewthread?GroupId=31&MessageKey=dbb79c8e-cc20-4b30-bb9b-b82e5394d2b9&CommunityKey=d543b8ba-9d3a-4121-85ce-5b68e6c31ce5&tab=digestviewer&ReturnUrl=%2fcommunities%2fcommunity-home%2fdigestviewer%3ftab%3ddigestviewer%26CommunityKey%3dd543b8ba-9d3a-4121-85ce-5b68e6c31ce5
------------------------------
Rabinder Devnani
Sterlite Technologies Limited
Original Message:
Sent: Oct 16, 2019 07:31
From: Hiren Shah
Subject: Communication API REST Specification Status for the multiple receivers
Hello,
As per the, Communication API REST Specification, we can provide multiple receivers for single communication message. It works fine for the normal happy scenario when message is sent successfully to all the receivers or in case where if fails for all.
But what should be status of communication message when system fails to send messages to few of the receivers.
Further we also want to re-send the failed notification after mannual intervation. so it is important to indetify for which of the receivers message has been already sent and for which it is failed.
How should be treat these case. Please suggest.
------------------------------
Hiren Shah
Sterlite Technologies Limited
------------------------------