# event/invitee: event invitees management

`invitee` groups commands to invite somebody to an event, get or set data about an invitee, and list all invitees. You can send an invitation by e-mail to people without XMPP account.

## get

Retrieve the RSVP status of one or several guest(s).

You may specify the guest(s) to retrieve by using their bare JIDs with `-j JIDS, --jid JIDS` as many times as necessary. By default, all guests RSVPs are retrieved.

If no response is known yet, no data is returned.

### example

Get RSVP of Louise:

    $ li event invitee get -u "xmpp:pubsub.example.net?;node=urn%3Axmpp%3Aevents%3A0%2Fparty;item=picnic_abd1" -j louise@example.org

## set

Set your own RSVP data.

Use `-f KEY VALUE, --field KEY VALUE` to specify the data to set. `KEY` can any field name used in the RSVP form, where usually `attending` is used (with the possible values of `yes`, `no`, and `maybe`).

### example

Indicate that you’ll come to a picnic:

    $ li event invitee set -s pubsub.example.net -n urn:xmpp:events:0/party -i picnic_abd1 -f attending yes

## list

Get and format the RSVP of your invitees. Note that as for libervia-cli_event_invitee_get and libervia-cli_event_invitee_set you must use invitees node and not the event node.

By default, only people who have answered are shown. You may use `-m, --missing` to show other people which were invited, but have not answered yet. When using this option, you can also use `-R, --no-rsvp` to only show people which have not answered yet.

You’ll also have a small summary indicating how many people who can expect at your event.

### example

Get the full list of invitees (including those who didn’t answered yet) with the RSVP formatted:

    $ li event invitee list -u "xmpp:pierre@example.net?;node=generic%2F876a2b99-1c90-41fa-b823-c4a467140770" -m

### invite

Invite somebody to an event. The invitation is done by e-mail, a guest account will be created. Contrary to other `invitee` commands, in this one you’ll use the event node directly.

This command is really similar to create

E-mail address is specified using `-e EMAIL, --email EMAIL` and you’ll need to give an URL template (using `-U URL_TEMPLATE, --url-template URL_TEMPLATE`)leading to your website page handling the invitation (for Libervia default invitation page is `<your_server>/g/<uuid>`). You can use `{uuid}` as a placeholder which will be replaced by event’s id.

You’ll probably want to specify the name of the invitee, using `-N NAME, --name NAME` and your own name (as the host inviting), using `-H HOST_NAME, --host-name HOST_NAME`. The language spoken by your guest can be specified using `-l LANG, --lang LANG`, it is mainly useful if you have many invitee speaking different languages.

### example

Pierre is inviting Louise (whose e-mail address is `louise_email@example.net`) to an event he’s organising:

    $ li event invitee invite -e louise_email@example.et -N "Louise" -H "Pierre" -l fr -U "https://www.example.org/g/{uuid}" -u "xmpp:pierre@example.org?;node=generic%2F61400ea7-a2a2-4ce0-9b68-3735b602f671"