Add Webchat ID

The Add Webchat ID operation allows you to associate a webchat session ID with an existing person record in Hablla. This action is the central point for connecting a visitor, often anonymous, from your website with a known contact profile in your CRM.

When a visitor starts a conversation in the webchat, they receive a unique session ID. If, during the conversation, that visitor identifies themselves (for example, by providing an email), you can use this operation to permanently link that chat session to the contact's profile.

This enriches the person's profile with the entire conversation history and allows agents to have a complete view of the customer in future interactions.

How to Configure

1. In Hablla Studio, add the "People" block to your automation flow.

2. In the "Operation" field, select the "Add Webchat ID" option.

3. In the "Person ID" field (personId), enter the identifier of the contact to which the webchat ID will be associated.

4. In the "Webchat ID" field, enter the variable that contains the chat session ID.

5. In the "Connection" field, select which of your webchat connections is being used.

---

Parameters

Field	Type	Required?	Description
Person ID	Text	✅ Yes	The unique ID of the person (contact) that will be linked to the chat session.
Webchat ID	Text	✅ Yes	The unique identifier of the webchat session, usually provided by the chatbot trigger.
Connection (connections)	Options List	✅ Yes	The specific webchat connection that originated the conversation.

Export to Spreadsheets

---

Structure (Using JSON)

The JSON request body must contain the webchat_id of the session and the connection corresponding.

JSON

{
  "webchat_id": "session_uuid_a1b2c3d4e5",
  "connections": [
    "connection_id_xyz987"
  ]
}

---

🚀 Example Use Case

Goal: When an anonymous visitor in the webchat provides their email to a chatbot, identify the contact in Hablla and associate the conversation with their profile.

1. The chatbot flow is programmed to ask for the visitor's email at a certain point in the conversation.

2. When the email is provided, the chatbot triggers a "Custom Event" in Hablla, sending the webchat_id of the session and the email collected.

3. The flow in Hablla begins with this trigger.

4. Use the "Find Person by Email" operation to find the personId corresponding to the received email.

5. Add a Condition (If) to check if a person was found.

6. If so, add the "People" block with the "Add Webchat ID" operation.

   • Person ID: Use the ID found in the search ({{steps.4.result.id}}).

   • Webchat ID: Use the ID coming from the trigger ({{trigger.body.webchat_id}}).

   • Connection: Select the webchat connection from your website.

With this flow, you turn an anonymous interaction into a recorded touchpoint in the customer's history, allowing any agent who takes over the conversation to have the full context of that customer's relationship with your company.