Resend Welcome Message

Description

Initiates sending the welcome message to the user associated with the case.
This message takes into account current user 'opt-in' status. If they are not yet opted in, it will ask them to verify by sending 'YES'. It will then provide them with info about the case and contact info for their rep.

Service Name	Resend Welcome Message
Service Type	REST
Method	GET
UAT (Sandbox) URL	https://integration.uat.marley.ai/api/case/actions/resend-welcome/{caseId}
Production URL	https://integration.himarley.io/api/case/actions/resend-welcome/{caseId}
Technical Documentation	View technical documentation with sample request and response payloads hosted on Postman.

 

Table of Contents

• API Request
  • Flow
  • Request Example
  • Request Path Breakdown
• API Response 
  • Response Payload Example
  • Response Fields Breakdown
• Common Errors to Handle
  • [404] Case Not Found

API Request

Flow

1. Send API request with the path parameter of the Hi Marley case Case ID.
2. Hi Marley receives the request and validates the Case ID exists.
3. Hi Marley resend the Welcome Message to the requested Case ID passed in the request.

Request Example

https://integration.uat.marley.ai/api/case/actions/resend-welcome/8f4acac7-9e77-4cc6-a2a9-e18dfae3873b1

 

Request Path Breakdown

Property	Values	Description	Type	Required	Example	Validation
caseId		The Case ID associated with the Hi Marley Case.	string	true	8f4acac7-9e77-4cc6-a2a9-e18dfae3873b1	caseId exists within Hi Marley.

 

API Response 

Response Payload Example

{
    "caseData": {
        "id": "8f4acac7-9e77-4cc6-a2a9-e18dfae3873b1",
        "archived": false,
        "claimNumber": "Auto-Test2727409123",
        "dateOfLoss": "2022-04-13T05:49:44.722Z",
        "policyNumber": "Auto-213r1s23456",
        "deductible": 1000,
        "brand": "TestBrand1"
    },
    "state": "open",
    "caseType": "claim",
    "customer": {
        "id": "81f45989-c62d-4544-93a5-fd8b5f9936e71",
        "first": "james-Luc",
        "last": "bond",
        "email": "[e-mail]",
        "mobile": "[phone]",
        "role": "enduser",
        "optStatus": true,
        "optStatusDetail": "OPTED_IN"
    },
    "primaryContact": {
        "id": "5bea662f-2026-4bfa-be39-57a9ae6b083f1",
        "first": "Jeremie",
        "last": "Quinones",
        "email": "[e-mail]",
        "role": "operator"
    },
    "createTime": "2022-08-30T16:47:28.619Z",
    "referenceId": "Auto-Test2727409123",
    "privacy": "public",
    "marleyNumber": "[phone]",
    "languagePreference": "en",
    "secondaryOperators": []
}

 

Response Fields Breakdown

Property	Element	Description	Type	Required	Example
caseData	id	The case identifier for the Hi Marley Case.	string	true	"id": "364ef9bb-fae5-4e2a-a746-cdca465a9c16"
	archived	Indicates if case is closed.	string	true	"archived": false
	claimNumber	Fields associated to claim/policy record.	string	true (only claim caseType)	"claimNumber": "Auto-Test2727409123"
	dateOfLoss		string	false	"dateOfLoss": "2022-04-13T05:49:44.722Z"
	policyNumber		string	true (only policy caseType)	"policyNumber": "Auto-213r1s23456"
	deductible		string	false	"deductible": 1000
	brand	Subsidiary/Underwriter associated with case	string	true (only if brands are in-use)	"brand": "TestBrand1"
state		The current status of the case state. open close	enum	true	"state": "open"
caseType		The type of Hi Marley Case. case claim policy	enum	true	"caseType": "claim"
customer	id	The identifier generated and assigned to the customer.	string	true	"id": "81f45989-c62d-4544-93a5-fd8b5f9936e71"
	first	The customers given name.	string	true	"first": "james-Luc"
	last	The last name of the person assigned to the Hi Marley case.	string	true	"last": "bond"
	email	The customers email address.	string	false	"email": "[e-mail]"
	mobile	The customers mobile number.	string	true	"mobile": "[phone]"
	role	The customers role. Always set to enduser.	enum	true	"role": "enduser"
	optStatus	The current opt status for the customer.	boolean	true	"optStatus": true
	optStatusDetail	Description of the current opt status for the customer.	string	true	"optStatusDetail": "OPTED_IN"
primaryContact	id	The identifier of the person assigned to the Hi Marley case.	string	true	"id": "5bea662f-2026-4bfa-be39-57a9ae6b083f1"
	first	The first name of the person assigned to the Hi Marley case.	string	true	"first": "Jeremie"
	last	The last name of the person assigned to the Hi Marley case.	string	true	"last": "Quinones"
	email	The email of the person assigned to the Hi Marley case.	string	false	"email": "[e-mail]"
	role	The role of the person assigned to the Hi Marley case.	string	true	"role": "operator"
createTime		The time of the case creation.	smalldatetime	true	"createTime": "2022-08-30T16:47:28.619Z"
referenceId		The case reference identifier for the Hi Marley Case.	string	true	"referenceId": "Auto-Test2727409123"
privacy		The case privacy status. public private-redacted	enum	true	"privacy": "public"
marleyNumber		The assigned phone number from an organization pool used to conduct messaging for the current case.	string	true	"marleyNumber": "[phone]"
languagePreference		The preferred language for the current Hi Marley case.	enum	true	"languagePreference": "en"
secondaryOperators (array)	id	The identifier of the person assigned to the Hi Marley case.	string	true	"id": "48e2ebc5-6055-4028-b384-66f03caba5th"
	first	The first name of the person assigned to the Hi Marley case.	string	true	"first": "Linda"
	last	The last name of the person assigned to the Hi Marley case.	string	true	"last": "Moon"
	email	The email of the person assigned to the Hi Marley case.	string	true	"email": "[e-mail]"
	role	The role of the person assigned to the Hi Marley case.	enum	true	"role": "operator"

 

Common Errors to Handle

• [404] Case Not Found -More Details