Create a Consultation Link

---

Step 1: Endpoint

POST https://api-staging.tenang.ai/chat-link

---

Step 2: Request Headers

Header	Type	Description
x-signature	string	HMAC signature to verify the request integrity
x-api-key	string	Tenant API key for authentication

---

Step 3: Request Body

Send a JSON object with the following fields:

{
  "tenantId": "tenant-123",
  "username": "johndoe",
  "externalId": "28819921",
  "userKey": "user-456",
  "email": "john.doe@example.com",
  "phoneNumber": "+123456789",
  "employersName": "ABC Corp",
  "insurersName": "XYZ Insurance",
  "policyNumber": "POL123456",
  "ip": "IP0",
  "type": "CHAT"
}

---

Step 4: Response

Example of a successful response:

{
  "statusCode": 201,
  "message": "Success create ChatLink",
  "data": {
    "id": "22a61931-5990-498c-bb56-a6342ba02ed4",
    "username": "tenant Test 2",
    "phoneNumber": "string",
    "externalId": "28819921",
    "employersName": "string",
    "insurersName": "string",
    "policyNumber": "string",
    "ip": "IP0",
    "type": "CHAT",
    "uniqueId": "7267ab28-c262-4e8b-a350-cb09b7727eeb",
    "chatLinkUrl": "https://consultation-staging.tenang.ai/chat/7267ab28-c262-4e8b-a350-cb09b7727eeb?tk=..."
  }
}

---

Step 5: Error Responses

Status Code	Message	Description
400	Invalid request data	Request body is missing fields or malformed
401	Unauthorized	API key or signature is missing or invalid
403	Forbidden	No permission to create consultation link
500	Internal Server Error	Unexpected error on the server

---

🔐 Security Considerations

• x-signature: HMAC signature generated using tenant's secret key
• x-api-key: Used to authenticate and authorize tenant

---

For more assistance, contact the TenangAI API support team.