Gift ideas: use for any request for a gift or present idea. Suggest store gifts from Befana’s verified stores, by what the person likes, the occasion and a price range. With person_id (from people) it leaves out what the sender already gave them and fits the suggestions to that person. A recipient can pass swap_for with one of their gift ids to see what they could swap it for. Works signed out.
输入参数limitqueryoccasionswap_formax_pricemin_priceperson_id
The people the signed-in sender has sent gifts to through Befana, with what they got and when. Names only: Befana never shares anyone’s address, email or phone. Use a person_id with find_gifts or send_gift.
无需输入参数。
Start a gift for someone. Give a catalog_id from find_gifts (or any product_url from a store), the recipient’s first name, and optionally their email or US mobile so they can see it in their own assistant. save:"preview" (default) shows the gift; save:"save" returns a link the sender opens to approve and pay on befana.app. Nothing is charged by this tool, and the recipient’s address is never asked for: they give it to Befana privately when they accept.
输入参数notesaveoptionoccasionsurpriseperson_idcatalog_idproduct_urlrecipient_emailrecipient_phonerecipient_first_name
Where the signed-in sender’s gifts stand: waiting for payment, waiting for the recipient, accepted, ordered, on its way, delivered, or declined. Never shows the recipient’s address or tracking.
输入参数gift_id
upcoming_occasions
Upcoming occasions
Birthdays, anniversaries and holidays coming up from the sender’s Befana reminders, soonest first, with who they are for.
输入参数days
Gifts sent to the signed-in person: who they’re from, what they are (unless a surprise), and where they stand. Gifts show up when the sender used this person’s email; otherwise pass the gift link they received as claim_link, once. Never shows what the sender paid.
输入参数claim_link
respond_to_gift
Answer a gift
Accept a gift (with the delivery address, which goes only to Befana and the store selling the gift), decline it, or swap it for something of similar value from find_gifts with swap_for. save:"preview" (default) shows what will happen; save:"save" sends the answer. The sender sees only that it was accepted or declined, never the address.
输入参数saveoptionaddressgift_id必填swap_toresponse必填
gift_preferences
My gift preferences
What the signed-in person likes, wants to avoid, and their sizes, so gifts sent to them fit. Senders never see these; they only shape the suggestions senders get. Leave everything out to read them; with values, save:"preview" (default) shows the change and save:"save" keeps it.
输入参数saveavoidlikesnotessizes
block_sender
Block a sender
Stop gifts from the sender of one of the signed-in person’s gifts. Their gifts no longer show up here, and Befana won’t start new gifts from them to this person. The sender isn’t told. save:"preview" (default) first; save:"save" blocks.
输入参数savegift_id必填
