Manage and track the leads in your campaigns and the state of their conversations
Each campaign has a Leads tab listing every contact in it. Here you can see the state of each conversation, read the message history, check the information the assistant collected, and keep contact details current.
Click View conversation to read the whole exchange between the lead and the assistant, with the information collected along the way. See Conversation history.
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Whappy Documentation","description":"AI-driven WhatsApp automation for lead qualification and appointment setting","colors":{"primary":"#0095FF","light":"#0095FF","dark":"#0095FF"},"logo":{"light":"https://mintcdn.com/whappy/kglCbESBYdWSPkHx/logo/light.png?fit=max\u0026auto=format\u0026n=kglCbESBYdWSPkHx\u0026q=85\u0026s=3b6821afdd1e7b66405bdfa84822d7f0","dark":"https://mintcdn.com/whappy/kglCbESBYdWSPkHx/logo/dark.png?fit=max\u0026auto=format\u0026n=kglCbESBYdWSPkHx\u0026q=85\u0026s=34f79c8a138bc7969ee2a22aa9c9f5b1"},"favicon":"https://mintcdn.com/whappy/kglCbESBYdWSPkHx/favicon.svg?fit=max\u0026auto=format\u0026n=kglCbESBYdWSPkHx\u0026q=85\u0026s=29a6fa2ce3660829b013e2a7188929d2","appearance":{"default":"light"},"background":{"decoration":"windows","color":{"dark":"#0a0814"}},"navbar":{"links":[{"href":"https://app.whappy.ai","label":"Log in"},{"href":"mailto:team@whappy.ai","label":"Support"}],"primary":{"type":"button","label":"Try Now","href":"https://whappy.ai/signup"}},"footer":{"socials":{"x":"https://x.com/whappy","github":"https://github.com/whappy-ai","linkedin":"https://linkedin.com/company/whappy-ai"}},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","href":"introduction"},{"language":"it","href":"it/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"whappy","hasAudioNarration":false,"actualSubdomain":"whappy","customDomains":["docs.whappy.ai"],"gitSource":{"type":"github","owner":"whappyai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad4e149904c2e51ab1bed3f","collectionId":"1230cdac-a9f6-43ee-aefe-b7b6daabd5ac","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad4e149904c2e51ab1bed3f"},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{},"buildId":"6ad4e149904c2e51ab1bed3f","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"en","tag":"Integrations","count":13},{"language":"it","tag":"Integrazioni","count":13},{"language":"en","tag":"Campaign","count":9},{"language":"it","tag":"Campagna","count":9},{"language":"en","tag":"Leads","count":8},{"language":"it","tag":"Lead","count":8},{"language":"en","tag":"Autopilot","count":7},{"language":"it","tag":"Autopilot","count":7},{"language":"en","tag":"Overview","count":6},{"language":"it","tag":"Panoramica","count":6},{"language":"en","tag":"Campaign Setup","count":5},{"language":"it","tag":"Configurazione campagna","count":5},{"language":"en","tag":"Lead Management","count":4},{"language":"it","tag":"Gestione dei lead","count":4},{"language":"en","tag":"Improving a campaign","count":3},{"language":"en","tag":"For existing customers","count":3},{"language":"it","tag":"Migliorare una campagna","count":3},{"language":"it","tag":"Per clienti esistenti","count":3},{"language":"en","tag":"Your workspace","count":2},{"language":"it","tag":"Il tuo spazio di lavoro","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"leads/overview","slug":"/leads/overview","pageMetadata":{"title":"Leads","description":"Manage and track the leads in your campaigns and the state of their conversations","icon":"users","href":"/leads/overview"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Manage and track the leads in your campaigns and the state of their conversations\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Each campaign has a `,_jsx(_components.strong,{children:`Leads`}),` tab listing every contact in it. Here you can see the state of each conversation, read the message history, check the information the assistant collected, and keep contact details current.`]}),`\n`,_jsx(Heading,{level:`2`,id:`the-leads-table`,children:`The leads table`}),`\n`,_jsx(Heading,{level:`3`,id:`lead-information-displayed`,children:`Lead information displayed`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Contact details:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Name`}),`: the lead’s name, with an `,_jsx(_components.strong,{children:`Opted out`}),` badge when they asked not to receive promotional messages`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Contact`}),`: the phone number, or the Instagram @username for a lead who wrote on Instagram`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Email`}),`: the email address, if you have one`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Labels`}),`: on campaigns for existing customers only, the labels on this customer`]}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Status indicators:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Conversation`}),`: Ready, Started, Active, Paused, Completed or Error`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Appointment`}),`: the date and time of the booking, or `,_jsx(_components.em,{children:`No appointment`})]}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Actions:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`View conversation`}),`: the message history and the information collected`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`View lead info`}),`: the lead’s profile, with every answer collected and the language the assistant writes to them in`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`search-and-filtering`,children:`Search and filtering`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Search bar:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Search by name, phone number or email`}),`\n`,_jsx(_components.li,{children:`Results update as you type`}),`\n`,_jsx(_components.li,{children:`Clear the search to see all leads`}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Filters:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Conversation state`}),` and a `,_jsx(_components.strong,{children:`date range`}),`, from the Filters button`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`All / WhatsApp / Instagram`}),`, on an account that uses both channels`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Tags`}),`, once at least one lead carries a label`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/leads/viewing-leads`,children:`Viewing leads`}),` for every column, state and filter.`]}),`\n`,_jsx(Heading,{level:`2`,id:`adding-new-leads`,children:`Adding new leads`}),`\n`,_jsxs(_components.p,{children:[`Open the `,_jsx(_components.strong,{children:`⋮`}),` menu and choose `,_jsx(_components.strong,{children:`Add a lead`}),` to add one contact by hand, or `,_jsx(_components.strong,{children:`Import from CSV`}),` for a list. See `,_jsx(_components.a,{href:`/leads/lead-management`,children:`Adding \u0026 managing leads`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`required-information`,children:`Required information`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Name`}),` `,_jsx(_components.em,{children:`(required)`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Phone number`}),` in full international format `,_jsx(_components.em,{children:`(required)`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`optional-information`,children:`Optional information`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`Email`})}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Additional information`}),`: your own fields with any extra data`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`adding-custom-information`,children:`Adding custom information`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Add field`}),` to create a custom field`]}),`\n`,_jsx(_components.li,{children:`Enter the field name and its value`}),`\n`,_jsx(_components.li,{children:`Useful for storing budget, company size, project details, and anything else the assistant should know`}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Example custom fields:`})}),`\n`,_jsx(CodeBlock,{numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Company: \"TechCorp Inc\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Budget: \"$10,000\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Industry: \"SaaS\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Priority: \"High\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`viewing-lead-details`,children:`Viewing lead details`}),`\n`,_jsx(Heading,{level:`3`,id:`conversation`,children:`Conversation`}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`View conversation`}),` to read the whole exchange between the lead and the assistant, with the information collected along the way. See `,_jsx(_components.a,{href:`/leads/conversation-history`,children:`Conversation history`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`lead-info`,children:`Lead info`}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`View lead info`}),` to see the lead’s profile:`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Contact details:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Name, phone and email`}),`\n`,_jsx(_components.li,{children:`How the lead is known on each channel, when they are on more than one`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Language`}),`: the language the assistant writes to them in and where it came from, with `,_jsx(_components.strong,{children:`Change`}),` to set it yourself`]}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Other lead information:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Every custom field and every answer collected in conversation`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`lead-status-indicators`,children:`Lead status indicators`}),`\n`,_jsx(Heading,{level:`3`,id:`conversation-status`,children:`Conversation status`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`State`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Ready`})}),_jsx(_components.td,{children:`In the campaign, no message sent yet`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Started`})}),_jsx(_components.td,{children:`The first message has gone out`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Active`})}),_jsx(_components.td,{children:`A conversation is under way`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Paused`})}),_jsx(_components.td,{children:`The conversation has been stopped`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Completed`})}),_jsx(_components.td,{children:`The lead reached the end of the funnel`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Error`})}),_jsx(_components.td,{children:`Something went wrong on this conversation`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`appointment-status`,children:`Appointment status`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Calendar icon and date`}),`: a meeting is booked, shown at that date and time`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No appointment`}),`: nothing booked yet`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`managing-your-leads`,children:`Managing your leads`}),`\n`,_jsx(Heading,{level:`3`,id:`organisation-tips`,children:`Organisation tips`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Use labels`}),`: on campaigns for existing customers, labels choose who an announcement goes to`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Regular review`}),`: check conversation progress regularly`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Follow up`}),`: use the appointment date for meeting preparation`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Data quality`}),`: keep contact information updated`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`common-actions`,children:`Common actions`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Search`}),`: find a lead quickly by any contact detail`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Filter`}),`: narrow the list by state, date, channel or label`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Review conversations`}),`: check qualification progress and how the assistant performs`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Delete`}),`: one lead from its row, or several at once with `,_jsx(_components.strong,{children:`Delete selected`}),`; conversations are kept`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Export`}),`: `,_jsx(_components.strong,{children:`Export to CSV`}),` in the `,_jsx(_components.strong,{children:`⋮`}),` menu downloads the leads currently listed`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`pagination`,children:`Pagination`}),`\n`,_jsx(_components.p,{children:`When you have many leads, the pager at the bottom of the tab moves between pages. It is only shown when there is more than one page.`}),`\n`,_jsx(Heading,{level:`2`,id:`best-practices`,children:`Best practices`}),`\n`,_jsx(Heading,{level:`3`,id:`lead-management`,children:`Lead management`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Regular monitoring`}),`: check new conversations daily`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Label consistently`}),`: use the same labels across similar customers`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Update information`}),`: keep lead data current as you learn more`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Country codes`}),`: a number without one is flagged in red and cannot be messaged`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`conversation-review`,children:`Conversation review`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Check the assistant’s performance`}),`: review how well it qualifies leads`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Identify patterns`}),`: look for common questions or concerns from leads`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Optimise flows`}),`: use what you learn to improve your funnel`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Follow up`}),`: act on completed conversations and booked appointments`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`data-organisation`,children:`Data organisation`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Meaningful labels`}),`: use labels that help with follow-up and targeting`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Custom fields`}),`: track information specific to your qualification process`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Clean data`}),`: remove or correct incomplete or incorrect information`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`lead-sources`,children:`Lead sources`}),`\n`,_jsx(_components.p,{children:`Leads appear in the table from several sources:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Instagram`}),`: people who message you or comment on a post, on a campaign that talks on Instagram`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Manual addition`}),`: contacts you add with `,_jsx(_components.strong,{children:`Add a lead`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`CSV import`}),`: lists you import`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`API/Webhook`}),`: leads sent from your own systems`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Integrations`}),`: contacts from connected tools such as Zapier, Make, your CRM, Meta lead ads or Shopify`]}),`\n`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Use the search to find a lead quickly before an important call or meeting. It works across names, phone numbers and email addresses.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Leads","description":"Manage and track the leads in your campaigns and the state of their conversations","icon":"users","href":"/leads/overview"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"The leads table","slug":"the-leads-table","depth":2,"children":[{"title":"Lead information displayed","slug":"lead-information-displayed","depth":3,"children":[]},{"title":"Search and filtering","slug":"search-and-filtering","depth":3,"children":[]}]},{"title":"Adding new leads","slug":"adding-new-leads","depth":2,"children":[{"title":"Required information","slug":"required-information","depth":3,"children":[]},{"title":"Optional information","slug":"optional-information","depth":3,"children":[]},{"title":"Adding custom information","slug":"adding-custom-information","depth":3,"children":[]}]},{"title":"Viewing lead details","slug":"viewing-lead-details","depth":2,"children":[{"title":"Conversation","slug":"conversation","depth":3,"children":[]},{"title":"Lead info","slug":"lead-info","depth":3,"children":[]}]},{"title":"Lead status indicators","slug":"lead-status-indicators","depth":2,"children":[{"title":"Conversation status","slug":"conversation-status","depth":3,"children":[]},{"title":"Appointment status","slug":"appointment-status","depth":3,"children":[]}]},{"title":"Managing your leads","slug":"managing-your-leads","depth":2,"children":[{"title":"Organisation tips","slug":"organisation-tips","depth":3,"children":[]},{"title":"Common actions","slug":"common-actions","depth":3,"children":[]}]},{"title":"Pagination","slug":"pagination","depth":2,"children":[]},{"title":"Best practices","slug":"best-practices","depth":2,"children":[{"title":"Lead management","slug":"lead-management","depth":3,"children":[]},{"title":"Conversation review","slug":"conversation-review","depth":3,"children":[]},{"title":"Data organisation","slug":"data-organisation","depth":3,"children":[]}]},{"title":"Lead sources","slug":"lead-sources","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"whappy","siteName":"Whappy Documentation","title":"Leads - Whappy Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/leads/overview","matchLevel":0},"it":{"href":"/it/leads/overview","matchLevel":1}}},"lastModified":"2026-10-18T12:55:51.037Z","originalFileLocation":"leads/overview.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Manage and track the leads in your campaigns and the state of their conversations\">\u003cmeta data-mint-head name=\"application-name\" content=\"Whappy Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/whappy/UbOIBIQAhwfLKZzi/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/whappy/UbOIBIQAhwfLKZzi/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/whappy/UbOIBIQAhwfLKZzi/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/whappy/UbOIBIQAhwfLKZzi/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/whappy/UbOIBIQAhwfLKZzi/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/whappy/UbOIBIQAhwfLKZzi/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/whappy/UbOIBIQAhwfLKZzi/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/whappy/UbOIBIQAhwfLKZzi/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/whappy/UbOIBIQAhwfLKZzi/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Leads - Whappy Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Manage and track the leads in your campaigns and the state of their conversations\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Whappy Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.whappy.ai/leads/overview\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://whappy.mintlify.app/_mintlify/api/og/v2?division=Lead+Management\u0026amp;title=Leads\u0026amp;description=Manage+and+track+the+leads+in+your+campaigns+and+the+state+of+their+conversations\u0026amp;theme=5306a3f9c915bb314cc5d7a0\u0026amp;signature=77f2256b4d06e486a92e1123e378e61e946a0e7a3b644ba9416827895f2afb77\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Leads - Whappy Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Manage and track the leads in your campaigns and the state of their conversations\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://whappy.mintlify.app/_mintlify/api/og/v2?division=Lead+Management\u0026amp;title=Leads\u0026amp;description=Manage+and+track+the+leads+in+your+campaigns+and+the+state+of+their+conversations\u0026amp;theme=5306a3f9c915bb314cc5d7a0\u0026amp;signature=77f2256b4d06e486a92e1123e378e61e946a0e7a3b644ba9416827895f2afb77\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/whappy/UbOIBIQAhwfLKZzi/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Whappy Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0095FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.whappy.ai/leads/overview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/leads/overview.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.whappy.ai/leads/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.whappy.ai/it/leads/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.whappy.ai/leads/overview\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.whappy.ai/#organization\",\"name\":\"Whappy Documentation\",\"url\":\"https://docs.whappy.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/whappy/kglCbESBYdWSPkHx/logo/light.png?fit=max\u0026auto=format\u0026n=kglCbESBYdWSPkHx\u0026q=85\u0026s=3b6821afdd1e7b66405bdfa84822d7f0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.whappy.ai#website\",\"name\":\"Whappy Documentation\",\"url\":\"https://docs.whappy.ai\",\"publisher\":{\"@id\":\"https://docs.whappy.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.whappy.ai/leads/overview#webpage\",\"url\":\"https://docs.whappy.ai/leads/overview\",\"name\":\"Leads\",\"description\":\"Manage and track the leads in your campaigns and the state of their conversations\",\"dateModified\":\"2026-10-18T12:55:51.037Z\",\"isPartOf\":{\"@id\":\"https://docs.whappy.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.whappy.ai/leads/overview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.whappy.ai/leads/overview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Whappy Documentation\",\"item\":\"https://docs.whappy.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Leads\",\"item\":\"https://docs.whappy.ai/leads/overview\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.whappy.ai/leads/overview#article\",\"headline\":\"Leads\",\"name\":\"Leads\",\"description\":\"Manage and track the leads in your campaigns and the state of their conversations\",\"url\":\"https://docs.whappy.ai/leads/overview\",\"mainEntityOfPage\":{\"@id\":\"https://docs.whappy.ai/leads/overview#webpage\"},\"dateModified\":\"2026-10-18T12:55:51.037Z\",\"publisher\":{\"@id\":\"https://docs.whappy.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.whappy.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Whappy Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Whappy Documentation","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Overview","icon":"house","pages":[{"title":"Overview","href":"/introduction"}]},{"tab":"Campaign","icon":"bullhorn","pages":[{"title":"Campaign","href":"/campaign/context"}]},{"tab":"Autopilot","icon":"wand-magic-sparkles","pages":[{"title":"Autopilot","href":"/autopilot/overview"}]},{"tab":"Leads","icon":"users","groups":[{"group":"Lead Management","pages":[{"title":"Leads","icon":"users","href":"/leads/overview"},{"title":"Viewing leads","description":"Find, filter and inspect the leads in a campaign.","icon":"table-list","href":"/leads/viewing-leads"},{"title":"Adding \u0026 managing leads","icon":"user-plus","href":"/leads/lead-management"},{"title":"Chats","icon":"comments","href":"/leads/conversation-history"}]}]},{"tab":"Integrations","icon":"plug","pages":[{"title":"Integrations","href":"/integrations/whatsapp"}]}]},{"language":"it","pages":[{"title":"it","href":"/it/leads/overview"}]}]},"basePath":"","title":"Leads - Whappy Documentation","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":[],"chunks":[]}
