Phone verification

No CLI command: this one is for your own backend, to verify a phone through WhatsApp OTP. An existing workspace and a WhatsApp sender are required; an agent deployment is not. It does not authenticate a visitor inside an agent conversation.

http

POST /api/v1/:slug/phone_verifications
Content-Type: application/json
Authorization: Bearer VATIO_DEVELOPER_TOKEN

{ "phone_number": "+56912345678" }

The 201 response contains verification_id and expires_at. Delivery is queued; 201 does not confirm that the code reached the phone. During the resend cooldown, the response is 429 with verification_id, expires_at, and retry_after_seconds.

http

POST /api/v1/:slug/phone_verifications/:id/verify
Content-Type: application/json
Authorization: Bearer VATIO_DEVELOPER_TOKEN

{ "code": "123456" }

Success returns { "verified": true }. An invalid code returns 422 with verified: false and attempts_left; five failed attempts lock the verification.

A workspace dedicated to this API declares agent: false — see the manifest.

Phone verification ​

Phone verification