[{"data":1,"prerenderedAt":896},["ShallowReactive",2],{"docs.navigation":3,"docs.content.email-power-up":342,"docs.section.power-ups":879,"docs.prevnext.email-power-up":893},[4,46,100,137,158,192,253,260,279,296,317],{"id":5,"title":6,"position":7,"children":8},32,"Introduction",0,[9,13,17,22,27,32,36,41],{"id":10,"title":6,"slug":11,"position":7,"directory":12},34,"getting-started","introduction",{"id":14,"title":15,"slug":16,"position":7,"directory":12},35,"Quickstart guide","quickstart-guide",{"id":18,"title":19,"slug":20,"position":21,"directory":12},37,"What is a bot?","what-is-a-bot",3,{"id":23,"title":24,"slug":25,"position":26,"directory":12},39,"What is a data source?","what-is-a-data-source",4,{"id":28,"title":29,"slug":30,"position":31,"directory":12},38,"What is a channel?","what-is-a-channel",6,{"id":33,"title":34,"slug":35,"position":31,"directory":12},40,"What is a power-up?","what-is-a-power-up",{"id":37,"title":38,"slug":39,"position":40,"directory":12},33,"FAQ","faq",7,{"id":42,"title":43,"slug":44,"position":45,"directory":12},36,"Troubleshooting","troubleshooting",8,{"id":7,"title":47,"position":48,"children":49},"Bots",1,[50,54,58,62,66,70,74,77,81,84,87,92,96],{"id":21,"title":51,"slug":52,"position":7,"directory":53},"Bot advanced settings","bot-advanced-settings","bots",{"id":55,"title":56,"slug":57,"position":48,"directory":53},10,"Prompt engineering tips","prompt-engineering-tips",{"id":59,"title":60,"slug":61,"position":59,"directory":53},2,"Available models","available-models",{"id":63,"title":64,"slug":65,"position":21,"directory":53},13,"Widget customisation","widget-customisation",{"id":67,"title":68,"slug":69,"position":26,"directory":53},12,"Webhooks","webhooks",{"id":71,"title":72,"slug":73,"position":71,"directory":53},5,"Custom domains","custom-domains",{"id":26,"title":75,"slug":76,"position":31,"directory":53},"Bot testing","bot-testing",{"id":78,"title":79,"slug":80,"position":31,"directory":53},11,"SDK","sdk",{"id":40,"title":82,"slug":83,"position":40,"directory":53},"Human takeover","human-takeover",{"id":31,"title":85,"slug":86,"position":55,"directory":53},"Duplicating bots","duplicating-bots",{"id":88,"title":89,"slug":90,"position":91,"directory":53},9,"My Chats","my-chats",15,{"id":48,"title":93,"slug":94,"position":95,"directory":53},"Analytics","analytics",16,{"id":45,"title":97,"slug":98,"position":99,"directory":53},"Lead capture","lead-capture",20,{"id":101,"title":102,"position":59,"children":103},23,"Data sources",[104,109,113,117,121,125,129,133],{"id":105,"title":106,"slug":107,"position":7,"directory":108},25,"File","file-data-source","data-sources",{"id":110,"title":111,"slug":112,"position":7,"directory":108},28,"Notion","notion-data-source",{"id":114,"title":115,"slug":116,"position":59,"directory":108},30,"Website","website-data-source",{"id":118,"title":119,"slug":120,"position":21,"directory":108},31,"YouTube","youtube-data-source",{"id":122,"title":123,"slug":124,"position":26,"directory":108},29,"RSS","rss-data-source",{"id":126,"title":127,"slug":128,"position":71,"directory":108},27,"Manual","manual-data-source",{"id":130,"title":131,"slug":132,"position":88,"directory":108},24,"Data source best practices","data-source-best-practices",{"id":134,"title":135,"slug":136,"position":55,"directory":108},26,"Keeping your bot up to date","keeping-your-bot-up-to-date",{"id":138,"title":139,"position":21,"children":140},41,"MCP",[141,146,150,154],{"id":142,"title":143,"slug":144,"position":48,"directory":145},44,"Getting started","mcp-getting-started","mcp",{"id":147,"title":148,"slug":149,"position":59,"directory":145},42,"Authentication","mcp-authentication",{"id":151,"title":152,"slug":153,"position":21,"directory":145},45,"Tools","mcp-tools",{"id":155,"title":156,"slug":157,"position":26,"directory":145},43,"Build a bot","mcp-build-a-bot",{"id":159,"title":160,"position":26,"children":161},14,"Channels",[162,167,171,175,178,181,185,188],{"id":163,"title":164,"slug":165,"position":7,"directory":166},21,"Web","web-channel","channels",{"id":168,"title":169,"slug":170,"position":48,"directory":166},18,"Slack","slack-bot-channel",{"id":172,"title":173,"slug":174,"position":48,"directory":166},19,"Slack (V1 Deprecated)","slack-channel",{"id":95,"title":176,"slug":177,"position":59,"directory":166},"Discord","discord-channel",{"id":99,"title":179,"slug":180,"position":21,"directory":166},"Telegram","telegram-channel",{"id":182,"title":183,"slug":184,"position":26,"directory":166},22,"WhatsApp","whatsapp-channel",{"id":91,"title":186,"slug":187,"position":71,"directory":166},"API","api-channel",{"id":189,"title":190,"slug":191,"position":45,"directory":166},17,"Email","email-channel",{"id":193,"title":194,"position":26,"children":195},52,"Power-ups",[196,201,205,209,213,217,221,225,229,233,237,241,245,249],{"id":197,"title":198,"slug":199,"position":7,"directory":200},54,"Browse Webpage Power-up","browse-webpage-power-up","power-ups",{"id":202,"title":203,"slug":204,"position":7,"directory":200},58,"Google Search Power-up","google-search-power-up",{"id":206,"title":207,"slug":208,"position":7,"directory":200},60,"Power-up basics","power-up-basics",{"id":210,"title":211,"slug":212,"position":7,"directory":200},65,"Use API Power-up","use-api-power-up",{"id":214,"title":215,"slug":216,"position":48,"directory":200},66,"Zapier Power-up","zapier-power-up",{"id":218,"title":219,"slug":220,"position":59,"directory":200},59,"Notion Power-ups","notion-power-ups",{"id":222,"title":223,"slug":224,"position":21,"directory":200},64,"Talk to a Human Power-up","talk-to-a-human",{"id":226,"title":227,"slug":228,"position":26,"directory":200},57,"Email Power-ups","email-power-up",{"id":230,"title":231,"slug":232,"position":71,"directory":200},62,"Send an email","send-email-power-up",{"id":234,"title":235,"slug":236,"position":55,"directory":200},63,"Slack Power-ups","slack-power-ups",{"id":238,"title":239,"slug":240,"position":78,"directory":200},55,"Discord Power-ups","discord-power-ups",{"id":242,"title":243,"slug":244,"position":67,"directory":200},53,"Bot-to-bot power-up","bot-to-bot-power-up",{"id":246,"title":247,"slug":248,"position":63,"directory":200},56,"Display power-ups","display-power-ups",{"id":250,"title":251,"slug":252,"position":159,"directory":200},61,"Power-up display modes","power-up-display-modes",{"id":254,"title":255,"position":71,"children":256},67,"Tasks",[257],{"id":258,"title":255,"slug":259,"position":7,"directory":259},68,"tasks",{"id":261,"title":262,"position":31,"children":263},69,"Teams",[264,267,271,275],{"id":265,"title":262,"slug":266,"position":7,"directory":266},70,"teams",{"id":268,"title":269,"slug":270,"position":48,"directory":266},71,"Inviting team members","teams-inviting",{"id":272,"title":273,"slug":274,"position":59,"directory":266},72,"Managing team members","teams-member-roles",{"id":276,"title":277,"slug":278,"position":21,"directory":266},73,"Transferring bots","teams-transferring-bots",{"id":280,"title":281,"position":31,"children":282},79,"Use cases",[283,288,292],{"id":284,"title":285,"slug":286,"position":7,"directory":287},82,"Build a support bot for your website","support-bot","use-cases",{"id":289,"title":290,"slug":291,"position":48,"directory":287},80,"Build an internal knowledge bot for your team","internal-knowledge-bot",{"id":293,"title":294,"slug":295,"position":59,"directory":287},81,"Build a lead capture bot for your website","lead-capture-bot",{"id":297,"title":298,"position":40,"children":299},74,"Usage and billing",[300,305,309,313],{"id":301,"title":302,"slug":303,"position":7,"directory":304},76,"How does billing work?","how-does-billing-work","usage-and-billing",{"id":306,"title":307,"slug":308,"position":7,"directory":304},78,"What are storage tokens?","what-are-storage-tokens",{"id":310,"title":311,"slug":312,"position":21,"directory":304},77,"What are message tokens?","what-are-message-tokens",{"id":314,"title":315,"slug":316,"position":26,"directory":304},75,"Add-ons","addons",{"id":318,"title":319,"position":45,"children":320},46,"Plans",[321,326,330,334,338],{"id":322,"title":323,"slug":324,"position":7,"directory":325},49,"Free","free-plan","plans",{"id":327,"title":328,"slug":329,"position":48,"directory":325},47,"Basic","basic-plan",{"id":331,"title":332,"slug":333,"position":59,"directory":325},51,"Standard","standard-plan",{"id":335,"title":336,"slug":337,"position":21,"directory":325},50,"Pro","pro-plan",{"id":339,"title":340,"slug":341,"position":26,"directory":325},48,"Enterprise","enterprise-plan",{"id":343,"title":227,"body":344,"description":870,"extension":871,"longTitle":872,"meta":873,"navigation":874,"path":875,"position":26,"seo":876,"stem":877,"__hash__":878},"docs\u002Fdocs\u002Fpower-ups\u002Femail-power-up.md",{"type":345,"value":346,"toc":842},"minimark",[347,362,367,377,385,413,417,428,435,438,444,448,451,456,459,473,476,480,500,506,511,516,519,522,525,529,532,538,558,562,565,623,626,629,632,636,639,645,661,664,667,710,714,717,720,723,727,730,734,740,743,746,749,753,756,759,762,782,788,792,832,836],[348,349,352],"callout",{"title":350,"type":351},"Just want to send notification emails?","info",[353,354,355,356,361],"p",{},"If you only need your bot to email a fixed set of recipients (e.g. lead capture or support hand-off alerts), the simpler ",[357,358,360],"a",{"href":359},"\u002Fdocs\u002Fsend-email-power-up","Send email power-up"," doesn't require connecting an inbox. The power-ups on this page are for bots that need to read, reply, and manage email from a real connected account.",[363,364,366],"h2",{"id":365},"email-power-ups-overview","Email power-ups overview",[353,368,369,370,376],{},"The email power-ups allow your bot to interact with a real email inbox - reading messages, sending emails, listing folders, and updating message status (read\u002Funread, starred). They are powered by ",[357,371,375],{"href":372,"rel":373},"https:\u002F\u002Fwww.nylas.com\u002F",[374],"nofollow","Nylas",", which connects to your email provider (Gmail, Outlook, etc.) via OAuth.",[353,378,379,380,384],{},"There are ",[381,382,383],"strong",{},"four"," email power-ups:",[386,387,388,395,401,407],"ul",{},[389,390,391,394],"li",{},[381,392,393],{},"Email: Get Messages"," - Retrieve messages from the inbox with filters (date range, sender, folder, unread status)",[389,396,397,400],{},[381,398,399],{},"Email: Send Message"," - Send emails on behalf of the connected account, with support for CC and replies",[389,402,403,406],{},[381,404,405],{},"Email: Get Folders"," - List all folders\u002Flabels in the email account (useful for filtering messages by folder)",[389,408,409,412],{},[381,410,411],{},"Email: Update Message"," - Mark messages as read\u002Funread, starred\u002Funstarred, or move them between folders",[363,414,416],{"id":415},"adding-an-email-power-up-to-your-bot","Adding an email power-up to your bot",[353,418,419,420,423,424,427],{},"From your bot's dashboard, navigate to the Power-ups tab. Click ",[381,421,422],{},"New power-up"," and search for \"Email\" to find the four email power-ups. Select the one you want and click ",[381,425,426],{},"Create power-up",".",[353,429,430],{},[431,432],"img",{"alt":433,"src":434},"Select an email power-up from the power-up catalog","https:\u002F\u002Fres.cloudinary.com\u002Fdjyjvrw5u\u002Fimage\u002Fupload\u002Fv1776428887\u002Fdocs\u002Femail-power-ups\u002Fdocs\u002Femail-power-ups\u002Femail-power-ups-catalog.png",[353,436,437],{},"Once created, your email power-ups will appear on the Power-ups tab:",[353,439,440],{},[431,441],{"alt":442,"src":443},"Email power-ups on the bot Power-ups tab","https:\u002F\u002Fres.cloudinary.com\u002Fdjyjvrw5u\u002Fimage\u002Fupload\u002Fv1776428885\u002Fdocs\u002Femail-power-ups\u002Fdocs\u002Femail-power-ups\u002Femail-power-ups-list.png",[363,445,447],{"id":446},"connecting-an-email-provider","Connecting an email provider",[353,449,450],{},"Before using any email power-up, you need to connect an email provider. This is done through Nylas OAuth.",[452,453,455],"h3",{"id":454},"pricing","Pricing",[353,457,458],{},"Adding an email provider incurs an additional charge on your subscription:",[386,460,461,467],{},[389,462,463,466],{},[381,464,465],{},"Monthly plan:"," $10\u002Fmonth per connected email provider",[389,468,469,472],{},[381,470,471],{},"Yearly plan:"," $120\u002Fyear per connected email provider",[353,474,475],{},"Your subscription is updated automatically when you connect a provider.",[452,477,479],{"id":478},"how-to-connect","How to connect",[481,482,483,486,493],"ol",{},[389,484,485],{},"Navigate to any email power-up's settings page",[389,487,488,489,492],{},"Click the ",[381,490,491],{},"Connect email"," button",[389,494,495,496,499],{},"A confirmation dialog will appear explaining the pricing - click ",[381,497,498],{},"Connect"," to proceed",[353,501,502],{},[431,503],{"alt":504,"src":505},"Connect an email provider confirmation dialog showing pricing","https:\u002F\u002Fres.cloudinary.com\u002Fdjyjvrw5u\u002Fimage\u002Fupload\u002Fv1776428891\u002Fdocs\u002Femail-power-ups\u002Fdocs\u002Femail-power-ups\u002Fconnect-nylas-modal.png",[481,507,508],{"start":26},[389,509,510],{},"A popup window will open for Nylas authentication - sign in with your email provider (Gmail, Outlook, etc.)",[481,512,513],{"start":71},[389,514,515],{},"Once authenticated, the popup will close automatically and your provider will appear in the email provider dropdown",[353,517,518],{},"You can connect multiple email providers to the same team. Each provider is billed separately.",[363,520,393],{"id":521},"email-get-messages",[353,523,524],{},"This power-up allows your bot to search and retrieve messages from the connected email inbox.",[452,526,528],{"id":527},"configuring-email-get-messages","Configuring Email: Get Messages",[353,530,531],{},"After creating the power-up you will see the settings screen:",[353,533,534],{},[431,535],{"alt":536,"src":537},"Email: Get Messages settings page","https:\u002F\u002Fres.cloudinary.com\u002Fdjyjvrw5u\u002Fimage\u002Fupload\u002Fv1776428888\u002Fdocs\u002Femail-power-ups\u002Fdocs\u002Femail-power-ups\u002Femail-get-messages-settings.png",[386,539,540,546,552],{},[389,541,542,545],{},[381,543,544],{},"Power-up name"," - A name your bot uses to identify this power-up",[389,547,548,551],{},[381,549,550],{},"Description"," - Instructions for your bot on when and how to use this power-up. Be specific about what kinds of queries the bot should handle (e.g. \"Search the inbox for emails matching a user's query. You can filter by sender, date range, and folder.\")",[389,553,554,557],{},[381,555,556],{},"Email provider"," - Select which connected email account to read from",[452,559,561],{"id":560},"how-it-works","How it works",[353,563,564],{},"Your bot can filter messages by:",[386,566,567,578,587,593,607,613],{},[389,568,569,572,573,577],{},[381,570,571],{},"Sender"," (",[574,575,576],"code",{},"from",") - Filter by sender email address",[389,579,580,572,583,586],{},[381,581,582],{},"Recipient",[574,584,585],{},"to",") - Filter by recipient email address",[389,588,589,592],{},[381,590,591],{},"Folder"," - Filter by folder\u002Flabel ID (use the Get Folders power-up to find folder IDs)",[389,594,595,598,599,602,603,606],{},[381,596,597],{},"Date range"," - Filter by ",[574,600,601],{},"receivedBefore"," and ",[574,604,605],{},"receivedAfter"," timestamps",[389,608,609,612],{},[381,610,611],{},"Limit"," - Control how many messages to return (default: 10)",[389,614,615,618,619,622],{},[381,616,617],{},"Pagination"," - Use the ",[574,620,621],{},"page"," token to fetch additional results",[353,624,625],{},"The bot receives message data including subject, sender, recipients, date, a text snippet, the full body (stripped of HTML), and read\u002Fstarred status.",[363,627,399],{"id":628},"email-send-message",[353,630,631],{},"This power-up allows your bot to compose and send emails from the connected email account.",[452,633,635],{"id":634},"configuring-email-send-message","Configuring Email: Send Message",[353,637,638],{},"After creating the power-up you will see the settings screen. Notice the default description instructs your bot to use HTML formatting:",[353,640,641],{},[431,642],{"alt":643,"src":644},"Email: Send Message settings page with HTML formatting instruction","https:\u002F\u002Fres.cloudinary.com\u002Fdjyjvrw5u\u002Fimage\u002Fupload\u002Fv1776428889\u002Fdocs\u002Femail-power-ups\u002Fdocs\u002Femail-power-ups\u002Femail-send-message-settings.png",[386,646,647,651,656],{},[389,648,649,545],{},[381,650,544],{},[389,652,653,655],{},[381,654,550],{}," - Instructions for your bot. The default description encourages the bot to use HTML formatting for email bodies, which is recommended for proper rendering in email clients.",[389,657,658,660],{},[381,659,556],{}," - Select which connected email account to send from",[452,662,561],{"id":663},"how-it-works-1",[353,665,666],{},"The bot can send emails with:",[386,668,669,675,681,698,704],{},[389,670,671,674],{},[381,672,673],{},"To"," - One or more recipient email addresses (required)",[389,676,677,680],{},[381,678,679],{},"Subject"," - The email subject line (required)",[389,682,683,686,687,690,691,690,694,697],{},[381,684,685],{},"Body"," - The email body content (required). Use HTML tags (",[574,688,689],{},"\u003Cp>",", ",[574,692,693],{},"\u003Cbr>",[574,695,696],{},"\u003Cstrong>",", etc.) for proper formatting.",[389,699,700,703],{},[381,701,702],{},"CC"," - Optional CC recipients",[389,705,706,709],{},[381,707,708],{},"Reply to message ID"," - Optional message ID to send as a reply to an existing thread",[452,711,713],{"id":712},"html-formatting-tip","HTML formatting tip",[353,715,716],{},"For best results, instruct your bot (via the description field) to always format email bodies using HTML. Plain text emails may not render line breaks correctly in some email clients.",[363,718,405],{"id":719},"email-get-folders",[353,721,722],{},"This power-up allows your bot to list all folders and labels in the connected email account.",[452,724,726],{"id":725},"configuring-email-get-folders","Configuring Email: Get Folders",[353,728,729],{},"There is not a huge amount to configure for this one. It has the standard power-up name and description settings, along with the email provider selector.",[452,731,733],{"id":732},"when-to-use-it","When to use it",[353,735,736,737,739],{},"This power-up is most useful in combination with ",[381,738,393],{},". The bot can first retrieve the list of folders to get folder IDs, then use those IDs to filter messages by folder.",[353,741,742],{},"For example, a user might ask \"Show me emails in my Promotions folder\" - the bot would first call Get Folders to find the folder ID for \"Promotions\", then call Get Messages filtered to that folder.",[363,744,411],{"id":745},"email-update-message",[353,747,748],{},"This power-up allows your bot to update the status of email messages.",[452,750,752],{"id":751},"configuring-email-update-message","Configuring Email: Update Message",[353,754,755],{},"Like the other email power-ups, this has the standard power-up name, description, and email provider settings.",[452,757,561],{"id":758},"how-it-works-2",[353,760,761],{},"The bot can update a message by its ID:",[386,763,764,770,776],{},[389,765,766,769],{},[381,767,768],{},"Mark as read\u002Funread"," - Toggle the unread status",[389,771,772,775],{},[381,773,774],{},"Star\u002Funstar"," - Toggle the starred status",[389,777,778,781],{},[381,779,780],{},"Move to folders"," - Move the message to one or more folders",[353,783,784,785,787],{},"This is often used in combination with ",[381,786,393],{},". For example, the user could say \"Mark all unread emails from Chris as read\" - the bot would first retrieve the matching messages, then update each one.",[363,789,791],{"id":790},"tips-and-known-limitations","Tips and known limitations",[386,793,794,800,814,820,826],{},[389,795,796,799],{},[381,797,798],{},"IMAP sync delay"," - Nylas syncs with your email provider via IMAP. Newly received emails and newly created folders may take a few minutes to appear in power-up results. This is an inherent limitation of the IMAP sync process.",[389,801,802,805,806,809,810,813],{},[381,803,804],{},"Date format for queries"," - When filtering messages by date, the bot should use standard date formats (e.g., ",[574,807,808],{},"2024-01-15"," or ",[574,811,812],{},"2024-01-15T10:30:00","). These are automatically converted to Unix timestamps for the Nylas API.",[389,815,816,819],{},[381,817,818],{},"HTML email bodies"," - Always instruct your bot to use HTML formatting when sending emails to ensure proper rendering across email clients.",[389,821,822,825],{},[381,823,824],{},"Folder IDs"," - Folder IDs are provider-specific. Use the Get Folders power-up to discover the correct folder IDs for filtering or moving messages.",[389,827,828,831],{},[381,829,830],{},"Multiple providers"," - You can connect multiple email accounts and assign different providers to different power-ups, allowing a single bot to manage multiple inboxes.",[363,833,835],{"id":834},"just-need-to-send-notifications","Just need to send notifications?",[353,837,838,839,841],{},"If your bot only needs to send emails to a small set of preconfigured addresses (e.g. lead capture, support hand-off, simple alerts), the ",[357,840,360],{"href":359}," is a lighter-weight alternative - no inbox connection or per-provider add-on required.",{"title":843,"searchDepth":59,"depth":59,"links":844},"",[845,846,847,851,855,860,864,868,869],{"id":365,"depth":59,"text":366},{"id":415,"depth":59,"text":416},{"id":446,"depth":59,"text":447,"children":848},[849,850],{"id":454,"depth":21,"text":455},{"id":478,"depth":21,"text":479},{"id":521,"depth":59,"text":393,"children":852},[853,854],{"id":527,"depth":21,"text":528},{"id":560,"depth":21,"text":561},{"id":628,"depth":59,"text":399,"children":856},[857,858,859],{"id":634,"depth":21,"text":635},{"id":663,"depth":21,"text":561},{"id":712,"depth":21,"text":713},{"id":719,"depth":59,"text":405,"children":861},[862,863],{"id":725,"depth":21,"text":726},{"id":732,"depth":21,"text":733},{"id":745,"depth":59,"text":411,"children":865},[866,867],{"id":751,"depth":21,"text":752},{"id":758,"depth":21,"text":561},{"id":790,"depth":59,"text":791},{"id":834,"depth":59,"text":835},"Give your bot the ability to read, send, and manage emails from a connected email account using Nylas.","md",null,{"prevPage":224},true,"\u002Fdocs\u002Fpower-ups\u002Femail-power-up",{"title":227,"description":870},"docs\u002Fpower-ups\u002Femail-power-up","JOEtYj7YAMwm43VJVsc54mFjx4LobkxkX45Ropzs5ac",{"id":880,"title":194,"body":881,"description":843,"extension":871,"longTitle":872,"meta":888,"navigation":874,"path":889,"position":26,"seo":890,"stem":891,"__hash__":892},"docs\u002Fdocs\u002Fpower-ups\u002F_index.md",{"type":345,"value":882,"toc":886},[883],[884,885,194],"h1",{"id":200},{"title":843,"searchDepth":59,"depth":59,"links":887},[],{},"\u002Fdocs\u002Fpower-ups\u002F_index",{"title":194,"description":843},"docs\u002Fpower-ups\u002F_index","s20pgTuoW2cyoNDQ10Yov9rIuWa6c8CJcrZB1HN0Bh8",{"prev":894,"next":895},{"title":223,"slug":224,"position":21,"directory":200},{"title":231,"slug":232,"position":71,"directory":200},1784559775312]