Atribuição de atendente
Atribui um atendente (corretor) à conversa de um lead que a Lastro encaminhou para o seu CRM. Use quando o seu CRM decide qual atendente deve cuidar do lead e quer que a Lastro reflita essa atribuição. Envie o token de acesso como Bearer no cabeçalho Authorization.
/v1/integrations/real-estate-agencies/{id}/leads/attendant-assignmentParâmetro de caminho
Identifique a imobiliária pelo seu real_estate_agency_id na URL.
| Campo | Tipo | Descrição |
|---|---|---|
idobrigatório | string (uuid) | O real_estate_agency_id da imobiliária. Precisa ser um id autorizado para a sua integração. |
{id} precisa ser um real_estate_agency_id presente na claim groups do seu token, no formato /real-estate-agencies/<id>. Gere um token e inspecione as claims na página de autenticação para descobrir quais imobiliárias a sua integração pode atender.Corpo da requisição
Envie o lead e o atendente que deve assumir a conversa, em JSON.
| Campo | Tipo | Descrição |
|---|---|---|
leadIdobrigatório | string (uuid) | O identificador do lead exatamente como a Lastro o enviou ao seu CRM no encaminhamento. |
attendantobrigatório | object | O atendente que deve assumir a conversa. |
attendant.emailobrigatório | string | E-mail do atendente. É como a Lastro o identifica — precisa corresponder ao e-mail cadastrado e ativo na imobiliária. |
attendant.nameobrigatório | string | Nome do atendente. |
Resposta
Um 200 confirma que o atendente foi atribuído à conversa do lead.
| Campo | Tipo | Descrição |
|---|---|---|
leadId | string (uuid) | O mesmo leadId enviado na requisição. |
status | string | Resultado da atribuição. Em caso de sucesso, "assigned". |
Erros
Códigos de erro que o endpoint pode retornar. Trate-os como erros — não repita a chamada cegamente.
| Campo | Tipo | Descrição |
|---|---|---|
400 | Bad Request | Payload inválido (ex.: leadId ausente ou e-mail malformado). |
401 | Unauthorized | Token ausente, inválido ou expirado. |
403 | Forbidden | A imobiliária não está autorizada para esta integração. |
404 | Not Found | Lead não encontrado para esta imobiliária. |
422 | Unprocessable Entity | Não foi possível atribuir: atendente não encontrado/elegível, ou a conversa do lead ainda não está pronta. |
500 | Internal Server Error | Erro interno ao processar a requisição. |
Atribuir um atendente
Cole o token obtido na página de autenticação e informe a imobiliária, o lead e o atendente para atribuir ao vivo.
Experimente
Cole o token gerado na página de autenticação e informe a imobiliária, o lead e o atendente. O token vai apenas para o nosso servidor, nunca direto do navegador, e nada fica armazenado.