With Lumo's Public API, you can access your Lumo data from your own systems and tools and combine it with your own setup. For detailed implementation specifications, see the "API documentation" inside Lumo.
What the Public API Is
The Public API is a mechanism for programmatically retrieving your Lumo data from external systems and applications.
You can call your Lumo data from your own systems without using Lumo's web interface. By combining the data you have accumulated with your own analytics platforms and tools, you can automate and streamline your work.
This is a feature for engineers. Using it requires knowledge of building systems with APIs.
What You Can Do With the API
The Public API lets you retrieve chat history, broadcast results, and customer information, and send LINE messages.
| What you can do | Details |
|---|---|
| Retrieve chat history | Retrieve the history of chats you exchanged with customers through your LINE Official Account, for a specified period |
| Retrieve broadcast results | Retrieve the list and details of message broadcasts, statistics such as opens and clicks, and per-recipient details |
| Look up customer information | Look up customer information in Lumo based on a LINE User ID |
| Send messages | Send a LINE message to a specified friend using an Auto Send Message template |
By specifying the target LINE Official Account and the period and number of records to retrieve, you can pull out only the data you need. You can build integrations such as importing broadcast results into your own data analytics platform, or sending a LINE message triggered by an event in your own system. We plan to add more available features over time.
For the latest list of available features and detailed specifications, see the "API documentation" inside Lumo.
Getting Started
To use the Public API, you issue an API key in an Enterprise plan workspace and implement your system so that it can call your Lumo data.
The Public API is available on the Enterprise plan. An API key is the key Lumo uses to authenticate access from your system. You issue and manage API keys under API Keys in your workspace settings.
Issuing an API Key
You issue an API key in your workspace settings.
- Open Workspace Settings and select API Keys
- Click Issue API Key
- Copy the displayed API key and store it in a safe place
The API key is shown only once, at the time it is issued. Keep it in a safe place. It cannot be displayed again after you close the screen, so if you lose it, you will need to regenerate it.
Building It Into Your System
Using the API key you issued, implement your system so it can call your Lumo data.
For the specifications you need to implement it, such as how to build requests and the format of the data you can retrieve, see View API Documentation.
Managing API Keys
You can review and regenerate your issued API key under API Keys in your workspace settings.
| Action | Details |
|---|---|
| View and copy | Review your issued API key on screen and copy it |
| Regenerate | Disable your current API key and issue a new one |
Regenerating an API Key
If you lose your API key, or if there is a chance it has been exposed to a third party, regenerate it.
- Open API Keys in your workspace settings
- Click Regenerate
- Click Regenerate in the confirmation dialog
When you regenerate, the previous API key becomes invalid, and this action cannot be undone. After regenerating, be sure to set the new API key in your system again.
Using It Safely
An API key is a key that can access your Lumo data. Manage it carefully so it is not exposed to third parties.
- Do not share your API key with third parties
- Do not write your API key directly into source code or public repositories
- If there is a chance your API key has been leaked, regenerate it immediately
- The API has a limit on the number of requests per time period. If you exceed the limit, your requests will be temporarily restricted
For details on usage limits, such as the request limit, see the "API documentation" inside Lumo.
Frequently Asked Questions
Common questions about using the Public API are answered below.
I Lost My API Key
Because the API key is shown only once when it is issued, it cannot be displayed again. Regenerate it from API Keys in your workspace settings. After regenerating, you will need to set the new API key in your system again.
What Data Can I Retrieve?
You can retrieve chat history, message broadcast results (statistics and per-recipient details), and the customer information that corresponds to a LINE User ID. You can also send LINE messages using an Auto Send Message template. We plan to add more available features over time.
Which Plans Can Use It?
The Public API is available on the Enterprise plan. On other plans, even if you issue an API key, calling the API will return an error. You can upgrade your plan from Settings > Usage & Billing.
Where Can I Find Details on How to Implement It?
From View API Documentation under API Keys in your workspace settings, you can find the specifications you need to implement it, such as how to build requests and the format of the data you can retrieve.