Pilot Support Macros¶
Last audited: 2026-06-25.
These macros give first-line support a safe starting reply for the paid pilot. They are written for Polish pilot users and keep legal, payment, and privacy claims narrow.
How To Use¶
- Pick the closest macro.
- Replace every
{placeholder}before sending. - Remove any line that does not match the user's case.
- Log the support contact with the user email or problem report ID, but do not copy passwords, one-time codes, raw tokens, full Stripe payloads, or private documents into the support log.
- Escalate when the macro says to escalate or when user-visible state does not match backend/admin state.
Shared Placeholders¶
{first_name}- user first name, ordzień dobrywhen unknown.{property_name}- property name visible in the app.{lease_label}- lease label, address, or tenant/owner context.{payment_title}- payment request title or period.{support_case_id}- support ticket/problem report identifier.{next_update_time}- concrete follow-up time in Europe/Warsaw time.
Guardrails¶
- Do not give legal advice.
- Do not say that MamNajem signs, serves, or legally delivers notices.
- Do not say payment proof means rent is legally settled. It means proof was attached in the app; owner confirmation is separate.
- Do not promise deletion while active or pending leases still exist.
- Do not ask users to send passwords, MFA codes, full bank details, card data, or Stripe receipt payloads over support.
- For Stripe rent payment issues, verify Stripe/admin state before telling the user to retry payment.
Failed Tenant Invite¶
Use when a tenant cannot accept an invitation, did not receive the invite, or sees an expired/invalid invitation.
Check first:
- Invitation email address matches the tenant's sign-in email.
- Invitation status is pending, accepted, revoked, or expired.
- Lease and tenant record still exist.
- User is not trying to accept the invite with a different account email.
Customer reply:
Cześć {first_name},
sprawdzimy zaproszenie do {property_name}. Najczęstszy powód problemu to inny adres e-mail niż ten, na który wysłano zaproszenie, albo wygasłe zaproszenie.
Proszę sprawdź:
1. Czy logujesz się adresem, na który przyszło zaproszenie.
2. Czy klikasz najnowszy link z wiadomości.
3. Czy zaproszenie nie zostało już przyjęte na innym koncie.
Jeśli dalej nie działa, odpisz proszę adresem e-mail, na który przyszło zaproszenie, i przybliżoną godziną próby. Nie wysyłaj hasła ani kodów logowania.
Numer sprawy: {support_case_id}
Internal next action:
- If email mismatch is confirmed, ask owner to revoke and resend invite to the correct address.
- If invitation is expired, ask owner to resend from the app.
- If backend shows a valid pending invite but the tenant cannot accept it, escalate with invitation ID, tenant email, lease ID, and screenshot/problem report ID.
Escalate when:
- Valid pending invite cannot be accepted.
- User was created but not linked to the lease tenant.
- Invite email delivery failed for multiple tenants.
Payment Proof Confusion¶
Use when tenant says they uploaded proof but owner does not see payment as paid, or owner thinks proof automatically settles rent.
Check first:
- Payment request exists and belongs to the lease.
- Receipt/proof attachment exists on the payment request.
- Payment request status and owner mark-paid action are visible.
Customer reply:
Cześć {first_name},
w MamNajem dowód płatności i oznaczenie płatności jako opłacone to dwa osobne kroki.
Dowód płatności pokazuje, że plik lub potwierdzenie zostało dodane do płatności {payment_title}. Właściciel nadal musi sprawdzić dowód i oznaczyć płatność jako opłaconą, jeśli się zgadza.
Proszę otwórz:
{property_name} -> Najem -> Płatności -> {payment_title}
Jeśli dowód jest widoczny, poczekaj na potwierdzenie właściciela. Jeśli dowodu nie widać, wyślij zgłoszenie problemu z ekranu płatności i dołącz zrzut ekranu bez danych wrażliwych.
Numer sprawy: {support_case_id}
Internal next action:
- If attachment exists, explain status separation and no backend action is needed.
- If attachment is missing after successful upload, check asset parent type and payment receipt linkage.
- If owner marked paid but tenant still sees pending, escalate with payment request ID and receipt ID.
Escalate when:
- Uploaded proof is lost or attached to the wrong payment request.
- Payment status differs between owner and tenant views.
- Storage download for an existing proof fails.
Handover Decline¶
Use when one side declines a handover protocol or asks what decline means.
Check first:
- Handover protocol status.
- Which participant declined.
- Whether decline notes or updated items exist.
Customer reply:
Cześć {first_name},
odrzucenie protokołu zdawczo-odbiorczego w MamNajem oznacza, że druga strona nie potwierdziła obecnej wersji i chce zmian lub wyjaśnienia.
To nie jest formalna decyzja prawna w aplikacji. To informacja w procesie uzgadniania protokołu.
Co możesz zrobić:
1. Otwórz protokół dla {property_name}.
2. Sprawdź notatki i pozycje, które wymagają poprawy.
3. Zaktualizuj protokół albo wyjaśnij sporne elementy w wiadomości.
4. Poproś drugą stronę o ponowne sprawdzenie.
Jeśli przycisk potwierdzenia lub edycji nie działa, wyślij zgłoszenie problemu z tego ekranu.
Numer sprawy: {support_case_id}
Internal next action:
- If status and UI controls are consistent, no technical action is needed.
- If status blocks expected edit/confirm actions, escalate with protocol ID, lease ID, participant role, and screenshot/problem report ID.
Escalate when:
- Protocol status is inconsistent between participants.
- Decline succeeds but notes/items do not persist.
- Confirm/decline action returns an error.
Billing Issue¶
Use when owner asks about subscription plan, checkout, invoice, cancellation, or billing portal.
Check first:
- Current subscription source and status.
- Whether billing is Stripe web, Apple, Google, or local/mock in integration.
- Whether Stripe portal URL is available for Stripe web subscriptions.
Customer reply:
Cześć {first_name},
sprawdzimy rozliczenie konta. W aplikacji aktualny plan i dostęp do płatności znajdziesz tutaj:
Konto -> Płatności
Jeśli subskrypcja była kupiona przez Stripe, przycisk portalu płatności prowadzi do zarządzania kartą, fakturami i anulowaniem. Jeśli zakup był przez sklep Apple albo Google, zmianę trzeba wykonać w ustawieniach subskrypcji tego sklepu.
Odpisz proszę:
1. Jaki status planu widzisz w aplikacji.
2. Czy płatność była przez Stripe, Apple czy Google.
3. Przybliżoną godzinę ostatniej próby płatności.
Nie wysyłaj numeru karty ani danych logowania.
Numer sprawy: {support_case_id}
Internal next action:
- Stripe web: check subscription current state, Stripe customer, invoice, and webhook events.
- Apple/Google: verify store confirmation state before changing app state.
- Integration/mock billing: explain that mock mode does not charge real cards.
Escalate when:
- Stripe invoice is paid but app status is not active.
- App shows active but Stripe/store status is canceled, failed, or revoked.
- User cannot open the billing portal for a Stripe web subscription.
Account Export¶
Use when user asks for a copy of their account data.
Check first:
- User can sign in.
- Account route
/account/data-exportis available. - If export fails, backend endpoint
/v1/users/current/data-exportstatus.
Customer reply:
Cześć {first_name},
eksport danych konta jest dostępny w aplikacji:
Konto -> Eksport danych
Eksport pokazuje dane powiązane z Twoim kontem, między innymi informacje o profilu, nieruchomościach, najmach, płatnościach, dokumentach, wiadomościach, powiadomieniach i aktywności. Część pól może być zaszyfrowana albo ukryta, jeśli tak działa przechowywanie danych w systemie.
Jeśli eksport nie otwiera się lub wygląda na niepełny, wyślij zgłoszenie problemu z aplikacji i napisz, której części brakuje.
Numer sprawy: {support_case_id}
Internal next action:
- If user cannot sign in, route to account access support before export.
- If export endpoint returns 401/403, verify identity and consent/allowlist filters.
- If export returns 500, escalate with request ID and user ID.
Escalate when:
- Export fails for authenticated user.
- User reports missing required categories.
- User requests formal GDPR handling beyond in-app export.
Account Deletion¶
Use when user asks to delete their account.
Check first:
- User can sign in and access
/account/delete-account. - Whether user has active or pending leases.
- Whether the request is account deletion, subscription cancellation, or both.
Customer reply:
Cześć {first_name},
konto możesz usunąć w aplikacji:
Konto -> Usuń konto
Usunięcie konta jest trwałe. Jeśli konto ma aktywne albo oczekujące najmy, aplikacja może najpierw poprosić o ich zakończenie lub uporządkowanie. To chroni dane najmu, protokoły i historię działań innych uczestników.
Jeśli chcesz tylko anulować subskrypcję, użyj:
Konto -> Płatności
To nie usuwa konta ani danych najmu.
Jeśli usunięcie konta kończy się błędem, wyślij zgłoszenie problemu i napisz, czy masz aktywne najmy.
Numer sprawy: {support_case_id}
Internal next action:
- If active/pending leases exist, explain blocker and do not bypass deletion manually.
- If no active/pending leases and deletion fails, escalate with user ID, request ID, role, and failure status.
- If user asks for billing cancellation, use the billing macro instead.
Escalate when:
- Deletion fails after active/pending leases are cleared.
- Storage cleanup or Cognito deletion fails.
- User requests manual GDPR deletion outside the app path.
Stripe Rent Payment Issue¶
Use when tenant rent checkout is visible and a tenant says card/BLIK/checkout payment failed, succeeded but app did not update, or returned to the wrong screen.
Check first:
- Payment request status and latest Stripe attempt.
- Stripe checkout session and payment intent state.
- Webhook status for related checkout/payment-intent events.
- Connect account readiness for the owner.
Customer reply:
Cześć {first_name},
sprawdzimy płatność za {payment_title}. Jeśli Stripe pokazał błąd, środki zwykle nie są pobierane, ale status zależy od metody płatności i potwierdzenia Stripe.
Proszę nie próbuj płacić ponownie, dopóki nie potwierdzimy statusu, jeśli:
- bank pokazuje obciążenie,
- Stripe pokazał sukces,
- aplikacja dalej pokazuje płatność jako oczekującą.
Odpisz proszę:
1. Przybliżoną godzinę płatności.
2. Kwotę i walutę.
3. Czy Stripe pokazał sukces, błąd, czy anulowanie.
Nie wysyłaj numeru karty, kodów bankowych ani pełnych danych płatności.
Wrócimy z aktualizacją do {next_update_time}.
Numer sprawy: {support_case_id}
Internal next action:
- If Stripe payment succeeded, verify receipt creation and payment request
status. Use webhook recovery runbook if a related webhook is
DEADor stuck inRETRYABLE. - If payment failed/canceled, confirm app attempt state before advising retry.
- If owner Connect account is not ready, explain that rent checkout is blocked until owner completes payment setup.
Escalate when:
- Stripe succeeded but app did not create receipt/update payment request.
- Payment intent is processing longer than expected.
- Dispute, refund, duplicate charge, or webhook replay is involved.
Evidence¶
EP7-T4 is complete when these macros are available to the Product Owner and linked from the pre-release docs and roadmap.