Faces and expressions

#Expressions

A flow's avatar is a set of expressions, each one of your faces with a name and a sentence saying when to use it. The agent picks the expression that fits the moment and lip-syncs whatever it says.

faces[].uuidstringrequired

The face, from Avatars.

faces[].labelstringrequired

The expression's name, e.g. neutral, happy, thinking.

faces[].usagestring

When to use it, in plain words.

#Transitions

A transition is a short clip played when moving from one expression to another. Without one, the switch is a quick cut.

transitions[].fromstringrequired

The expression label it leaves.

transitions[].tostringrequired

The expression label it arrives at.

transitions[].uuidstringrequired

The clip, from Avatars.

transitions[].labelstring

A name for it.

#From code

1await voxio.flows.update(flowKey, {
2  faces: [
3    { uuid: "FACE_NEUTRAL", label: "neutral", usage: "Default while listening and explaining." },
4    { uuid: "FACE_HAPPY",   label: "happy",   usage: "Greetings and good news." },
5  ],
6  transitions: [
7    { from: "neutral", to: "happy", uuid: "CLIP_SMILE", label: "smile" },
8  ],
9});

If you update faces without transitions (or the other way round), the one you leave out is kept.

#Good source faces

Face the camera, mouth closed and relaxed, even light, plain background, no hands near the face. A few seconds of gentle movement looks more alive than a still photo.

#Next steps

• Lip-sync: make the mouth match.