BETA

Atualiza o source type de uma conversa existente. É usado quando o fluxo da conversa muda depois de ter sido criada — por exemplo, quando o visitante começa conversando com a IA e em algum momento passa para um modo de contato direto (sem IA).

Informação do recurso
AutenticaçãoObrigatória (Token de API, Bearer)
Scopemapaprop-chat-ai
HTTP MethodPOST
ResponseJSON
Version1

URL do recurso

https://mapaprop.app/api/action/mapaprop-chat-ai-v1/question/{questionId}/source-type

Parâmetros

KeyTypeRequiredDescrição
questionIdintsimID da conversa. É enviado como parte da URL (path param).
sourceTypeintsimO novo source type. Valores conhecidos: 10 = chat com IA, 11 = chat com IA que passou para modo contato direto.
sourceNamestringnãoEtiqueta legível do source type, exibida no Inbox. Se for omitida e sourceType for 10 ou 11, é preenchida automaticamente com MapapropChatAI ou MapapropChatAI-Contact respectivamente. Para qualquer outro sourceType, fica sem valor se você não a enviar.

Código de exemplo

POST /api/action/mapaprop-chat-ai-v1/question/481203/source-type HTTP/1.1
Host: mapaprop.app
Content-Type: application/json
Authorization: Bearer {access_token}

{
    "sourceType": 11
}

Resposta

ObjetoCampoTipoObrigatórioDescrição
Responsesuccessbooleansimtrue quando a atualização foi bem-sucedida.

Em caso de erro, não chega {"success": false}: a requisição é cortada com um erro (ver tabela a seguir).

Erros

ErroCausa
QUESTION_NOT_FOUNDO questionId enviado não existe ou não pertence a este cliente.

Erros de validação (a requisição é cortada, não chega success: false)

ErroCausa
REQUIRED_INPUT — "questionId is required"O path param questionId não é um número válido.
REQUIRED_INPUT — "sourceType is required"Falta o campo sourceType.

Exemplo de resposta

{
    "success": true
}