ask_question
ChatGPTUse this when the user asks about visa requirements, eligibility, required documents, official fees, processing times, urgent or express options, or appointment booking (VFS Global, BLS, TLScontact) for travel from the UAE or for UAE residents and GCC-based travellers, or about UAE residence, freelance and investor visas. Pass the user's question as is, in any language; the answer comes back in the same language. Send only what the user asked, never results of other tools (verdicts, rule ids, eligibility details). Skip it for flights, hotels, travel insurance and legal immigration advice. Three outcomes. ANSWERED: a ready answer. CLARIFY: the knowledge base needs the country or visa type; the response contains a follow-up question and options. Ask the user, then call again with the same session_id and the chosen option as the question (e.g. "Japan"). ABSTAIN: the knowledge base has no entry for this question. Tell the user so, offer the contact from the closing block, and add no answer of your own. ANSWERED and ABSTAIN responses end with a closing block that starts with "Source:". Give the direct answer first, then show that block, translated into the user's language; keep the company name, licence number, rating, phone, e-mail and links unchanged. When the user asks what TheVisa does or how to proceed, describe the service from that block and offer the WhatsApp contact. Pass session_id from a previous response when continuing the same conversation; omit it for a new one.
check_eligibility
ChatGPTUse this when the user wants TheVisa to handle their visa application and you need to know whether TheVisa can take the case. Checks the trip against TheVisa's eligibility rules and returns a strict verdict: eligible, not_eligible or need_more_data. Pass everything you already know; only destination is required. need_more_data lists what to ask: ask the user in one message, then call again with all facts (old and new). Never guess facts the user has not stated. eligible: tell the user the case can be taken, ask for their phone number with country code (or call phone_form to show a form), then call submit_application with the eligibility_id. not_eligible: explain the reasons, do not call submit_application, and keep helping with ask_question.
contact_manager
ChatGPTUse this when the user wants TheVisa to handle their visa, asks how to apply or get help from TheVisa, or wants to talk to a manager. Shows a card with a "Continue on WhatsApp" button that opens a chat with a TheVisa manager. Takes no arguments. After calling it, add at most one short sentence; do not repeat the card text.
phone_form
ChatGPTShows a form where the user can type their phone number, as an alternative to typing it in the chat. Only after check_eligibility returned eligible. The number arrives as the user's next message; then call submit_application. After calling, add at most one short sentence.
submit_application
ChatGPTUse this to send the user's application to TheVisa managers, only after check_eligibility returned eligible in this conversation and the user gave a phone number. A TheVisa manager will contact the user by phone. Pass the phone in international format with country code (+971…). In case_summary, briefly state in English what the user asked TheVisa to do (destination, travellers, dates, purpose) — only what the user stated for this request, no conversation transcript and no sensitive personal data. One check, one application. If the user corrects their phone number or name after submitting, call submit_application again with the same eligibility_id and the corrected value: the application is updated and the managers are notified. Calling again with nothing changed sends nothing.
