loop:
    # Send a prompt to the user asking for their preferred contact method.
    response = talk(
        "Hi there! What's your preferred contact method (email, phone, or SMS)?",
        True,
        {"preferred_contact": "email"} // Example default value
    )
until "User provides a valid contact method":
    contactInfo = response.ask(
        question="Extract and validate the contact method from the response.",
        example={"preferred_contact": "email"}
    )
    # Validate the contact method; if invalid, the prompt repeats.
    if contactInfo["preferred_contact"] not in ["email", "phone", "SMS"]:
        print("Invalid contact method provided. Re-prompting...")
    else:
        print("Valid contact method received!")

# Extract structured details (full name and email) from a user response.
userDetails = response.ask(
    question="Return the user's full name and email address.",
    example={"full_name": "John Doe", "email": "john.doe@example.com"}
)

# Define a tool schema
get_appointment = {
    "name": "get_appointment",
    "description": "Book an appointment when user provides date and time",
    "parameters": {
        "type": "object",
        "properties": {
            "date": {"type": "string", "description": "Appointment date"},
            "time": {"type": "string", "description": "Appointment time"}
        },
        "required": ["date", "time"]
    }
}

# Use with parameter binding
loop:
    response = talk("When would you like to schedule your appointment?", True)
until "user wants to cancel":
    say("No problem, cancelled.")
until get_appointment as appointment:
    # appointment contains: {"date": "...", "time": "..."}
    say(f"Booked for {appointment['date']} at {appointment['time']}!", exact=True)

state = {}

# Store data during conversation
state["user_name"] = "John"
state["order_items"] = []

# Access later in the flow
say(f"Hello again, {state['user_name']}!", exact=True)

print("Processing order...")
print(f"Order data: {order_data}")

result = await send_sms(
    to="+12025551234",
    content="Your order is confirmed!",
    from_number="+15551234567"  # From your phone library
)

if result.success:
    say("Confirmation sent!", exact=True)

response = requests.get(
    url="https://api.example.com/users/123",
    headers={"Authorization": "Bearer token"}
)

if response.ok:
    user = response.json()
    say(f"Found user: {user['name']}", exact=True)

# POST requests
response = requests.post(
    url="https://api.example.com/orders",
    headers={"Content-Type": "application/json"},
    json={"items": order_items}
)

state = {}
meta_prompt = "You're an assistant that helps the user book shifts."
res = say("Hello, I'm a chatbot. Let's start by gathering your details.")

loop:
    # Initiate conversation to collect user details.
    phone_response = talk(
        f"{meta_prompt} Please provide your phone number, full name, and facility name. Confirm these details once provided.",
        True,
        {"phone_number": "+16179011508", "full_name": "John Doe", "facility_name": "Facility A"}
    )
until "User has provided phone number, full name, and facility name and confirmed them":
    # Extract the user details.
    info = phone_response.ask(
        question="Extract the user's phone number, full name, and facility name.",
        example={"phone_number": "+16179011508", "full_name": "John Doe", "facility_name": "Facility A"}
    )
    
    # Verify details via API
    response = requests.get(
        url='https://apigateway.example.com/api/facilities',
        headers={
            'authorization': 'Bearer 123',
            'cbh-facility-user-phone-number-auth': info["phone_number"]
        }
    )
    answer_ = response.json().ask(
        question="Verify the provided details. If successful, return the user's name, facility name, and email; otherwise, return 'ERROR'.",
        example={"name": "John Doe", "facility_name": "Facility A", "email": "john.doe@example.com", "success": true}
    )
    print("Answer:", answer_)

    if not answer_["success"]:
        loop:
            phone_response = talk("Sorry, we couldn't verify your details. Please re-enter your information.", True)
        until "User confirms corrected details":
            info = phone_response.ask(
                question="Return the user's phone number, full name, and facility name.",
                example={"phone_number": "+16179011508", "full_name": "John Doe", "facility_name": "Facility A"}
            )
            state["info"] = info
    else:
        print("Verification successful:", answer_)

# Basic transfer
transfer("+1-800-123-4567")

# Transfer with extension (dials extension after call connects)
transfer("5302321272", "123")

# Transfer with extension and custom pause time
transfer("5302321272", {"extension": "123", "pauseSeconds": 2})

say("Thank you for calling. Goodbye!", exact=True)
end_call()