Skip to main content
With the hellomateo Embed, you can integrate your customer chats directly into your own systems — for example, your ERP, CRM, or internal dashboard. This makes communication faster, easier, and keeps your team in one workspace.

​
🧭 Two ways to show your inbox

You can embed either a single conversation or your entire inbox.

​
Option 1: Single conversation

Show only one customer chat — perfect for displaying the chat directly in your ERP next to a contact. 👉 URL format: 
https://app.getmateo.com/embed/conversations/<conversation_id>/single

​
Option 2: Full inbox

Display all your conversations in one view. 👉 URL: 
https://app.getmateo.com/embed/conversations
To make it work, simply add your employee access token at the end of the URL: 
?access_token=<employee_token>
✅ Examples: Single conversation: 
https://app.getmateo.com/embed/conversations/12345/single?access_token=abcd1234
Full inbox: 
https://app.getmateo.com/embed/conversations?access_token=abcd1234

​
🧩 How to get the conversation for a contact

If you want to show the chat for a specific customer, you’ll need their conversation ID. Here’s how to find it via the API (for example, using the external_id):

​
1️⃣ Get the conversation by external ID

curl --request GET   --url "https://integration.getmateo.com/api/v1/contact?external_id=eq.<external_id>&select=conversation(id)"   --header "Authorization: Bearer <token>"
You’ll receive a conversation.id in the response — use it in your embed link.

​
🔑 Create an Employee Token

If you don’t have an employee token yet, you can create one in your hellomateo account:
  1. Go to Settings → Integrations → Employee Tokens
  2. Click Create Employee Token
  3. Enter a token name, select the employee, and click Create Token
  4. Copy and save the token — it will only be shown once