Yellow.ai
Connect your Yellow.ai bot from Connecter > Yellow.ai in the Oktivo dashboard. The connector works in two directions.Availability depends on your Oktivo plan. If you do not see the Yellow.ai tile in Connecter, ask support to enable it.
What you get
Website chatbot to Oktivo lead. When a visitor shares a phone number in your Yellow.ai chatbot, Oktivo creates a lead (or updates the lead that already has that number) and saves the chat on it. Your team can then call the lead from Oktivo. Oktivo call result to Yellow.ai. After an Oktivo call finishes and has been analysed, Oktivo writes the contact and the call status onto the matching customer profile in Yellow.ai.Before you start
- A Yellow.ai bot, and a Yellow.ai user who can open Settings > API Keys.
- An Oktivo account with the Yellow.ai connector enabled.
- For chatbot leads: someone who can edit the bot flow in Yellow.ai Studio.
Connect your bot
1
Get the API key from Yellow.ai
In Yellow.ai, open Settings > API Keys and create or copy an API key for your bot.
2
Find the bot ID and region host
The bot ID identifies your bot, for example
x1234567890123. The region host is the Yellow.ai address for your region, for example cloud.yellow.ai. Type only the host name. A leading https:// or a trailing / is removed for you.3
Connect in Oktivo
Open Connecter, find Yellow.ai, and click Connect. Enter the API key, the bot ID, and the region host. Oktivo checks them with Yellow.ai before saving. The key is encrypted and is never shown again.
If connecting fails
Settings
After connecting, click Settings on the Yellow.ai card. Your choices are saved and shown again when you reopen the panel.
Pulling your existing Yellow.ai contacts into Oktivo is also not available yet.
Only a finished, analysed call sends data to Yellow.ai. Changing a lead’s status by hand in Oktivo does not.
Create leads from your chatbot
1
Generate a secret
In the Yellow.ai settings, click Generate secret. Oktivo shows it once. Copy it and keep it somewhere safe.
2
Turn on Create leads from chatbot
The switch stays off until a secret exists.
3
Add an API node in Yellow.ai Studio
Add an API node right after the step where the bot collects the visitor’s phone number, and set it up as shown below.
API node settings
The settings panel in Oktivo shows the exact URL and a ready-to-copy example. Use those values.Body
Send the
transcript or a summary if your flow can. For long chats, send userId and leave out the transcript: Oktivo then fetches the whole chat from Yellow.ai itself. Fetching with userId has not been confirmed against a live bot, so it may not work for every setup. If it fails, the lead is still created and keeps the summary.
What is saved from Yellow.ai
- The full chat. Every message, in order, with who wrote it (visitor, bot or agent) and the time. Sending the same chat again changes nothing. Sending a longer version of the same chat adds the new messages. A shorter, older copy is ignored.
- Profile details. Details such as name, email, city and country are copied to the lead only where the lead has nothing better yet. An existing name, email or location is never overwritten. Everything else (language, time zone, last channel and your own Yellow.ai properties) is kept in the Yellow.ai profile card on the lead. If you turned off pulling name or email in your field mapping, those two are not copied, but they still show in the profile card.
- Optional profile lookup. Oktivo can also look up the profile from Yellow.ai with
userId. This is switched off by default because it has not been confirmed against a live bot. Ask your administrator if you want it enabled.
Test it
Ask a developer to send this request with your own values, or use the example in the settings panel:How leads appear in Oktivo
- The lead’s channel is Yellow.ai and its source is Website chatbot. You can filter on both in the lead list.
- Your bot ID is saved on the lead.
- The chat is saved as one entry in the lead’s conversation timeline, counted under Notes. The entry shows the last few messages. Click View full chat to read the whole conversation as a scrollable chat with visitor, bot and agent bubbles and times. Long chats load 100 messages at a time as you scroll, with Load more, Jump to latest and Load older buttons.
- If a chat was very long, a banner tells you that only part was saved. If it is still being copied from Yellow.ai, the banner says it is still syncing. If the copy stopped early, it says Partially synced and finishes the next time Yellow.ai sends the same chat.
- A collapsible Yellow.ai profile card (in the Marketing section of the lead) lists the details Yellow.ai had for the visitor. It is hidden when there are none.
- Deleting the lead also deletes its saved chat.
- If the phone number already belongs to a lead (added by hand, imported, or from another connector), that lead is updated instead of duplicated. It keeps its original channel. The chatbot visit is added to its history.
- If the same visitor chats again with a different conversation, the new chat is added as another entry.
Sync activity
Click Sync activity on the Yellow.ai card to see recent activity, newest first. You will see one row for each lead created or updated from the chatbot, and one for each push after a call. Rows marked skipped were not processed on purpose, for example because a setting was off, the phone number was missing, or the chat could not be fetched. Rows marked failed include the reason.Troubleshooting
A phone number without a country code is treated as Indian (
+91). For visitors in other countries, make your flow add the country code before it sends the number.FAQ
Does it copy my whole Yellow.ai contact list into Oktivo?
Does it copy my whole Yellow.ai contact list into Oktivo?
No. It only creates a lead when your bot flow sends one, which is when a visitor shares a phone number. Importing existing Yellow.ai contacts is not available yet.
What happens if the same visitor is sent twice?
What happens if the same visitor is sent twice?
Nothing is duplicated. The same delivery is recognised and ignored. A repeat visit with the same phone number updates the existing lead.
Will a lead be created without a phone number?
Will a lead be created without a phone number?
No. A request without a valid phone number is refused and no lead is created.
Why does Log call activity do nothing?
Why does Log call activity do nothing?
Oktivo does not write call summaries to Yellow.ai yet. The switch is a placeholder until that is available.
Does changing a lead's status in Oktivo update Yellow.ai?
Does changing a lead's status in Oktivo update Yellow.ai?
No. Only a finished, analysed call sends data to Yellow.ai, and what it sends is the call outcome.
Can I use the same bot in two Oktivo accounts?
Can I use the same bot in two Oktivo accounts?
No. A bot can be connected to one Oktivo account at a time.
What happens if I disconnect?
What happens if I disconnect?
Syncing stops and your Yellow.ai settings and secret are removed. If you reconnect later, you start with the default settings and generate a new secret.
Where is my API key stored?
Where is my API key stored?
It is encrypted and never shown again. To change it, connect again with the new key. Your settings are kept when you reconnect without disconnecting first.
Related
Lead Capture
Other ways to bring leads into Oktivo
CRM Integration Guide
Generic CRM setup with code samples