Actions34
- Cliente Actions
- Catálogo Actions
- Pedido Actions
- Conversa Actions
- Contexto Actions
- Telemetria Actions
- Canal WhatsApp Actions
- Paciente Actions
- Procedimento Actions
- Agenda Actions
- Agendamento Actions
- Lembrete Odonto Actions
Cliente → Buscar
AI-generatedSummary
Lookup a client by their phone number to retrieve client details along with their recent order history.
Inputs
- Telefone (required) — Client's phone number in E.164 format (e.g., +5511999999999). This should be normalized before use — only digits with country code.
- Token ID Dinamico — Optional dynamic token returned by multi-tenant bootstrap; must be used together with a dynamic Signing Secret for authentication.
- Signing Secret Dinamico — Optional ephemeral secret returned by bootstrap; must be used together with the dynamic Token ID. Should never be logged or exposed in outputs.
Output shape
a single JSON object containing the client information and recent order history.
The operation issues a signed GET request to the endpoint
/api/v1/agent/cliente?telefone=PHONE. If dynamic token and signing secret overrides are provided, they authenticate the request instead of stored credentials. The response includes the client data and recent orders. Errors return standard HTTP error codes and messages.