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