Conectar chamada telefônica a usuário

Este endpoint cria uma ligação telefônica para um usuário interno e conecta com o cliente.

POST /Conversation/create-phone-call-to-user

Este endpoint cria uma ligação telefônica para um usuário interno e conecta com o cliente.

Autenticação

Autenticação obrigatória. Envie sua chave de API de usuário no header X-API-Key.

Parâmetros

Esta operação não possui parâmetros de rota, query ou header.

Corpo da requisição

Content type: application/json · Schema: CreatePhoneCallToUserRequestDto

Propriedade	Tipo	Obrigatório	Descrição	Restrições
`connectorType`	`ConnectorType`	Não	—	—
`userId`	`integer · int32`	Não	—	aceita null
`userEmail`	`string`	Não	—	aceita null
`customerPhoneNumber`	`string`	Não	—	aceita null
`callerId`	`string`	Não	—	aceita null
`queueId`	`integer · int32`	Não	—	aceita null

Exemplo de requisição

curl --request POST \
  --url 'https://api.zild.ai/Conversation/create-phone-call-to-user' \
  --header 'X-API-Key: YOUR_USER_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "connectorType": 0,
  "userId": 0,
  "userEmail": "string",
  "customerPhoneNumber": "string",
  "callerId": "string",
  "queueId": 0
}'

Respostas

Status	Descrição	Corpo da resposta
`200`	Ligação criada com sucesso	`application/json` · `CreatePhoneCallToUserResponseDto`

Exemplo de resposta (200):

{
  "callSid": "string",
  "conversationId": 0,
  "userId": 0,
  "userEmail": "string",
  "customerPhoneNumber": "string",
  "callerId": "string",
  "status": "string"
}

Modelos de dados

ConnectorType

0 = AnalysisService; 1 = PostgreSQL; 2 = MySQl; 3 = SQLServer; 4 = GoogleBigQuery; 5 = AzureOpenAI; 6 = Chart; 7 = OracleDB; 8 = Deepgram; 9 = AzureSpeech; 10 = AzureLanguageNotUsedAnymore; 11 = AzureStorage; 12 = RetellAI; 13 = AzureVision; 14 = OriginalSoftware; 15 = GoogleApi; 16 = OpenAI; 17 = AzureAiDocumentIntelligence; 18 = ElevenLabs; 19 = Twilio; 20 = Anthropic; 21 = GoogleGemini; 22 = Monday; 23 = Omie; 24 = MEM9

integer

CreatePhoneCallToUserRequestDto

Propriedade	Tipo	Obrigatório	Descrição	Restrições
`connectorType`	`ConnectorType`	Não	—	—
`userId`	`integer · int32`	Não	—	aceita null
`userEmail`	`string`	Não	—	aceita null
`customerPhoneNumber`	`string`	Não	—	aceita null
`callerId`	`string`	Não	—	aceita null
`queueId`	`integer · int32`	Não	—	aceita null

CreatePhoneCallToUserResponseDto

Propriedade	Tipo	Obrigatório	Descrição	Restrições
`callSid`	`string`	Não	—	aceita null
`conversationId`	`integer · int32`	Não	—	—
`userId`	`integer · int32`	Não	—	—
`userEmail`	`string`	Não	—	aceita null
`customerPhoneNumber`	`string`	Não	—	aceita null
`callerId`	`string`	Não	—	aceita null
`status`	`string`	Não	—	aceita null