Steg 2: anslut datakällor och inställningar

Definiera API-endpoints och kör datahämtning parallellt för hyresgästposter, serviceärenden och feedbackloggar.

1. Öppna Workflow Settings Map och ange följande värden:
2. Ställ in tenantApiUrl till <__PLACEHOLDER_VALUE__Tenant API endpoint URL__>.
3. Ställ in serviceRequestApiUrl till <__PLACEHOLDER_VALUE__Service Request API endpoint URL__>.
4. Ställ in feedbackApiUrl till <__PLACEHOLDER_VALUE__Feedback API endpoint URL__>.
5. Ställ in crmApiUrl till <__PLACEHOLDER_VALUE__CRM API endpoint URL__> och dashboardApiUrl till <__PLACEHOLDER_VALUE__Dashboard API endpoint URL__>.
6. Ställ in churnRiskThreshold till 70.
7. Bekräfta att Workflow Settings Map matar ut till Retrieve Tenant Records, Retrieve Service Tickets och Retrieve Feedback Logs parallellt.
8. I Retrieve Tenant Records, ställ in URL till {{ $('Workflow Settings Map').first().json.tenantApiUrl }} och aktivera Send Headers med Content-Type: application/json.
9. I Retrieve Service Tickets, ställ in URL till {{ $('Workflow Settings Map').first().json.serviceRequestApiUrl }} och aktivera Send Headers med Content-Type: application/json.
10. I Retrieve Feedback Logs, ställ in URL till {{ $('Workflow Settings Map').first().json.feedbackApiUrl }} och aktivera Send Headers med Content-Type: application/json.

Workflow Settings Map matar ut till både Retrieve Tenant Records, Retrieve Service Tickets och Retrieve Feedback Logs parallellt.

⚠️ Vanlig fallgrop: Om era API:er kräver autentisering, lägg till headers eller credentials i noderna för HTTP Request innan ni testar.

Steg 3: sammanställ data och konfigurera AI-insiktsmotorn

Kombinera källdata och analysera churn-risk med AI-agenten med en strukturerad output-parser.

1. Öppna Assemble Tenant Insights och bekräfta dessa tilldelningar:
2. Ställ in tenantData till {{ $('Retrieve Tenant Records').all() }}.
3. Ställ in serviceRequests till {{ $('Retrieve Service Tickets').all() }}.
4. Ställ in feedbackData till {{ $('Retrieve Feedback Logs').all() }}.
5. Öppna Tenant Insight Agent och ställ in Text till Analyze this tenant data: {{ JSON.stringify($json) }}.
6. Säkerställ att Tenant Insight Agent har OpenAI Model Core ansluten som språkmodell.
7. Credential krävs: Anslut era openAiApi-credentials i OpenAI Model Core.
8. Säkerställ att Structured Output Parser är kopplad till Tenant Insight Agent med befintligt JSON-schema.

För AI-undernoder som Structured Output Parser hanteras credentials på föräldernoden. Säkerställ att credentials för OpenAI Model Core är inställda för Tenant Insight Agent.

Steg 4: konfigurera riskdirigering och kommunikationsåtgärder

Dirigera hyresgäster baserat på churn-risk och trigga rätt spår för uppföljning och belöning.

1. Öppna Churn Risk Gate och ställ in villkoret så att det jämför {{ $('Tenant Insight Agent').item.json.churnRiskScore }} mot {{ $('Workflow Settings Map').first().json.churnRiskThreshold }} med Number → Greater Than or Equal.
2. På grenen true, bekräfta att High Risk Outreach Agent är ansluten.
3. I High Risk Outreach Agent, behåll Text inställd på High-risk tenant detected: {{ $json.tenantName }} (ID: {{ $json.tenantId }}). Churn risk: {{ $json.churnRiskScore }}%. Key issues: {{ JSON.stringify($json.keyIssues) }}. Recommended actions: {{ JSON.stringify($json.recommendedActions) }}..
4. Säkerställ att OpenAI Comms Model är ansluten som språkmodell för High Risk Outreach Agent.
5. Credential krävs: Anslut era openAiApi-credentials i OpenAI Comms Model.
6. Bekräfta att High Risk Outreach Agent har verktygskopplingar till Gmail Dispatch Tool och Slack Alert Tool.
7. Credential krävs: Anslut era gmailOAuth2-credentials i Gmail Dispatch Tool.
8. Credential krävs: Anslut era slackOAuth2Api-credentials i Slack Alert Tool.
9. På grenen false, bekräfta att Low Risk Appreciation är ansluten till Send Loyalty Reward Mail.
10. I Low Risk Appreciation, bekräfta att emailSubject är Thank You for Being a Valued Tenant! och att emailBody använder den angivna HTML:en med {{ $json.tenantName }}.
11. I Send Loyalty Reward Mail, ställ in Send To till {{ $json.tenantEmail || '<__PLACEHOLDER_VALUE__Tenant email field from data__>' }}, Message till {{ $json.emailBody }} och Subject till {{ $json.emailSubject }}.
12. Credential krävs: Anslut era gmailOAuth2-credentials i Send Loyalty Reward Mail.

För AI-verktyg som Gmail Dispatch Tool och Slack Alert Tool tillämpas credentials på verktygsnoderna, medan AI-exekveringen styrs av High Risk Outreach Agent.

⚠️ Vanlig fallgrop: Säkerställ att output-fälten från AI-verktygen är tillgängliga—saknade $fromAI-fält resulterar i tomma e-postmeddelanden eller Slack-meddelanden.

Steg 5: uppdatera CRM- och dashboardposter

Spara insikter i ert CRM och uppdatera er dashboard för retention efter uppföljning eller belöningar.

1. Öppna Update CRM Record och ställ in URL till {{ $('Workflow Settings Map').first().json.crmApiUrl }}.
2. Ställ in Method till POST och JSON Body till {{ { tenantId: $json.tenantId, satisfactionScore: $json.satisfactionScore, churnRiskScore: $json.churnRiskScore, churnRiskLevel: $json.churnRiskLevel, lastAnalyzed: new Date().toISOString(), actionsTaken: $json.recommendedActions } }}.
3. Aktivera Send Body, Send Headers, och ställ in Content-Type till application/json.
4. Öppna Refresh Retention Dashboard och ställ in URL till {{ $('Workflow Settings Map').first().json.dashboardApiUrl }}.
5. Ställ in Method till POST och JSON Body till {{ { tenantId: $json.tenantId, tenantName: $json.tenantName, satisfactionScore: $json.satisfactionScore, churnRiskScore: $json.churnRiskScore, churnRiskLevel: $json.churnRiskLevel, engagementLevel: $json.engagementLevel, timestamp: new Date().toISOString() } }}.

Steg 6: testa och aktivera er workflow

Kör ett manuellt test för att validera datahämtning, AI-output, dirigering och kommunikationsåtgärder innan ni aktiverar schemat.

1. Klicka på Execute Workflow för att köra Scheduled Tenant Review manuellt.
2. Verifiera att Workflow Settings Map förgrenar till Retrieve Tenant Records, Retrieve Service Tickets och Retrieve Feedback Logs parallellt.
3. Kontrollera output från Tenant Insight Agent och bekräfta att Structured Output Parser producerar churnRiskScore, churnRiskLevel och recommendedActions.
4. Bekräfta att Churn Risk Gate dirigerar högriskhyresgäster till High Risk Outreach Agent och lågriskhyresgäster till Low Risk Appreciation.
5. Verifiera att e-post och Slack-notifieringar skickas korrekt, och att Update CRM Record och Refresh Retention Dashboard tar emot förväntade payloads.
6. När ni har verifierat, slå om workflowen till Active så att Scheduled Tenant Review körs automatiskt.