> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://apidocs.makimoto.ai/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.makimoto.ai/_mcp/server. # transcriptDelivered - Successful delivery POST https://webhooks/transcript-delivered Content-Type: application/json Delivered to your ``callback_url`` once a transcription request submitted with a ``callback_url`` finishes (or after delivery is abandoned on terminal failure). The transcript ``data`` matches the inline (200) response; ``request_id`` is at the top level (not nested under ``data``). Delivery: - ``POST {callback_url}`` with ``Content-Type: application/json``; the body is the JSON shape below. - Up to 3 attempts, with exponential backoff between tries and a 30 s per-request timeout. - Retried on transport errors and on any non-2xx response. After the final attempt the delivery is abandoned (logged server-side; there is no API to query abandoned deliveries). Receiver contract: - Respond with any 2xx to acknowledge and stop retries; any non-2xx triggers a retry until the attempt cap. - Deliveries are not signed and carry no idempotency key — correlate and dedupe on ``request_id``. Reference: https://apidocs.makimoto.ai/makimoto-api-docs/webhooks/transcript-delivered-successful-delivery ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: collection version: 1.0.0 paths: /webhooks/transcript-delivered: post: operationId: transcript-delivered-successful-delivery summary: transcriptDelivered - Successful delivery description: > Delivered to your ``callback_url`` once a transcription request submitted with a ``callback_url`` finishes (or after delivery is abandoned on terminal failure). The transcript ``data`` matches the inline (200) response; ``request_id`` is at the top level (not nested under ``data``). Delivery: - ``POST {callback_url}`` with ``Content-Type: application/json``; the body is the JSON shape below. - Up to 3 attempts, with exponential backoff between tries and a 30 s per-request timeout. - Retried on transport errors and on any non-2xx response. After the final attempt the delivery is abandoned (logged server-side; there is no API to query abandoned deliveries). Receiver contract: - Respond with any 2xx to acknowledge and stop retries; any non-2xx triggers a retry until the attempt cap. - Deliveries are not signed and carry no idempotency key — correlate and dedupe on ``request_id``. tags: - subpackage_webhooks parameters: - name: apikey in: header description: API key required when calling through the API gateway. required: false schema: type: string responses: '200': description: >- Your receiver acknowledges with any 2xx, which stops retries. Any non-2xx triggers a retry until the attempt cap. content: application/json: schema: $ref: >- #/components/schemas/webhooks_transcriptDelivered - Successful delivery_Response_200 requestBody: content: application/json: schema: type: object properties: status: type: string request_id: type: string call_uuid: type: string data: $ref: >- #/components/schemas/WebhooksTranscriptDeliveredPostRequestBodyContentApplicationJsonSchemaData required: - status - request_id - call_uuid - data servers: - url: https:/ description: https://{baseurl} components: schemas: WebhooksTranscriptDeliveredPostRequestBodyContentApplicationJsonSchemaDataMetadata: type: object properties: sample_rate: type: integer mode: type: string timestamp: type: integer lang: type: string codec: type: string transcribed_mode: type: string num_of_channels: type: integer audio_duration: type: number format: double required: - sample_rate - mode - timestamp - lang - codec - transcribed_mode - num_of_channels - audio_duration title: >- WebhooksTranscriptDeliveredPostRequestBodyContentApplicationJsonSchemaDataMetadata WebhooksTranscriptDeliveredPostRequestBodyContentApplicationJsonSchemaDataTranscriptItems: type: object properties: text: type: string time_start: type: integer time_end: type: number format: double speaker_id: type: integer speaker_alias: type: string required: - text - time_start - time_end - speaker_id - speaker_alias title: >- WebhooksTranscriptDeliveredPostRequestBodyContentApplicationJsonSchemaDataTranscriptItems WebhooksTranscriptDeliveredPostRequestBodyContentApplicationJsonSchemaData: type: object properties: id: type: string metadata: $ref: >- #/components/schemas/WebhooksTranscriptDeliveredPostRequestBodyContentApplicationJsonSchemaDataMetadata transcript: type: array items: $ref: >- #/components/schemas/WebhooksTranscriptDeliveredPostRequestBodyContentApplicationJsonSchemaDataTranscriptItems required: - id - metadata - transcript title: >- WebhooksTranscriptDeliveredPostRequestBodyContentApplicationJsonSchemaData webhooks_transcriptDelivered - Successful delivery_Response_200: type: object properties: {} description: Empty response body title: webhooks_transcriptDelivered - Successful delivery_Response_200 ``` ## Examples **Request** ```json { "status": "S001", "request_id": "f9f23b27019a553c04c2d4280d37fd42", "call_uuid": "call-abc123", "data": { "id": "29051cac-89b5-49ec-a932-006c8cc57-0febd3.wav", "metadata": { "sample_rate": 16000, "mode": "POST", "timestamp": 1780635349, "lang": "en", "codec": "", "transcribed_mode": "POST", "num_of_channels": 2, "audio_duration": 571.66 }, "transcript": [ { "text": "Hello, how can I help you today?", "time_start": 0, "time_end": 2.5, "speaker_id": 0, "speaker_alias": "Agent" }, { "text": "I'd like to check my account balance.", "time_start": 1, "time_end": 5.1, "speaker_id": 1, "speaker_alias": "User" } ] } } ``` **Response** ```json {} ``` **SDK Code** ```python import requests url = "https://https/webhooks/transcript-delivered" payload = { "status": "S001", "request_id": "f9f23b27019a553c04c2d4280d37fd42", "call_uuid": "call-abc123", "data": { "id": "29051cac-89b5-49ec-a932-006c8cc57-0febd3.wav", "metadata": { "sample_rate": 16000, "mode": "POST", "timestamp": 1780635349, "lang": "en", "codec": "", "transcribed_mode": "POST", "num_of_channels": 2, "audio_duration": 571.66 }, "transcript": [ { "text": "Hello, how can I help you today?", "time_start": 0, "time_end": 2.5, "speaker_id": 0, "speaker_alias": "Agent" }, { "text": "I'd like to check my account balance.", "time_start": 1, "time_end": 5.1, "speaker_id": 1, "speaker_alias": "User" } ] } } headers = { "apikey": "{{apikey}}", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://https/webhooks/transcript-delivered'; const options = { method: 'POST', headers: {apikey: '{{apikey}}', 'Content-Type': 'application/json'}, body: '{"status":"S001","request_id":"f9f23b27019a553c04c2d4280d37fd42","call_uuid":"call-abc123","data":{"id":"29051cac-89b5-49ec-a932-006c8cc57-0febd3.wav","metadata":{"sample_rate":16000,"mode":"POST","timestamp":1780635349,"lang":"en","codec":"","transcribed_mode":"POST","num_of_channels":2,"audio_duration":571.66},"transcript":[{"text":"Hello, how can I help you today?","time_start":0,"time_end":2.5,"speaker_id":0,"speaker_alias":"Agent"},{"text":"I\'d like to check my account balance.","time_start":1,"time_end":5.1,"speaker_id":1,"speaker_alias":"User"}]}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://https/webhooks/transcript-delivered" payload := strings.NewReader("{\n \"status\": \"S001\",\n \"request_id\": \"f9f23b27019a553c04c2d4280d37fd42\",\n \"call_uuid\": \"call-abc123\",\n \"data\": {\n \"id\": \"29051cac-89b5-49ec-a932-006c8cc57-0febd3.wav\",\n \"metadata\": {\n \"sample_rate\": 16000,\n \"mode\": \"POST\",\n \"timestamp\": 1780635349,\n \"lang\": \"en\",\n \"codec\": \"\",\n \"transcribed_mode\": \"POST\",\n \"num_of_channels\": 2,\n \"audio_duration\": 571.66\n },\n \"transcript\": [\n {\n \"text\": \"Hello, how can I help you today?\",\n \"time_start\": 0,\n \"time_end\": 2.5,\n \"speaker_id\": 0,\n \"speaker_alias\": \"Agent\"\n },\n {\n \"text\": \"I'd like to check my account balance.\",\n \"time_start\": 1,\n \"time_end\": 5.1,\n \"speaker_id\": 1,\n \"speaker_alias\": \"User\"\n }\n ]\n }\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("apikey", "{{apikey}}") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://https/webhooks/transcript-delivered") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["apikey"] = '{{apikey}}' request["Content-Type"] = 'application/json' request.body = "{\n \"status\": \"S001\",\n \"request_id\": \"f9f23b27019a553c04c2d4280d37fd42\",\n \"call_uuid\": \"call-abc123\",\n \"data\": {\n \"id\": \"29051cac-89b5-49ec-a932-006c8cc57-0febd3.wav\",\n \"metadata\": {\n \"sample_rate\": 16000,\n \"mode\": \"POST\",\n \"timestamp\": 1780635349,\n \"lang\": \"en\",\n \"codec\": \"\",\n \"transcribed_mode\": \"POST\",\n \"num_of_channels\": 2,\n \"audio_duration\": 571.66\n },\n \"transcript\": [\n {\n \"text\": \"Hello, how can I help you today?\",\n \"time_start\": 0,\n \"time_end\": 2.5,\n \"speaker_id\": 0,\n \"speaker_alias\": \"Agent\"\n },\n {\n \"text\": \"I'd like to check my account balance.\",\n \"time_start\": 1,\n \"time_end\": 5.1,\n \"speaker_id\": 1,\n \"speaker_alias\": \"User\"\n }\n ]\n }\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://https/webhooks/transcript-delivered") .header("apikey", "{{apikey}}") .header("Content-Type", "application/json") .body("{\n \"status\": \"S001\",\n \"request_id\": \"f9f23b27019a553c04c2d4280d37fd42\",\n \"call_uuid\": \"call-abc123\",\n \"data\": {\n \"id\": \"29051cac-89b5-49ec-a932-006c8cc57-0febd3.wav\",\n \"metadata\": {\n \"sample_rate\": 16000,\n \"mode\": \"POST\",\n \"timestamp\": 1780635349,\n \"lang\": \"en\",\n \"codec\": \"\",\n \"transcribed_mode\": \"POST\",\n \"num_of_channels\": 2,\n \"audio_duration\": 571.66\n },\n \"transcript\": [\n {\n \"text\": \"Hello, how can I help you today?\",\n \"time_start\": 0,\n \"time_end\": 2.5,\n \"speaker_id\": 0,\n \"speaker_alias\": \"Agent\"\n },\n {\n \"text\": \"I'd like to check my account balance.\",\n \"time_start\": 1,\n \"time_end\": 5.1,\n \"speaker_id\": 1,\n \"speaker_alias\": \"User\"\n }\n ]\n }\n}") .asString(); ``` ```php request('POST', 'https://https/webhooks/transcript-delivered', [ 'body' => '{ "status": "S001", "request_id": "f9f23b27019a553c04c2d4280d37fd42", "call_uuid": "call-abc123", "data": { "id": "29051cac-89b5-49ec-a932-006c8cc57-0febd3.wav", "metadata": { "sample_rate": 16000, "mode": "POST", "timestamp": 1780635349, "lang": "en", "codec": "", "transcribed_mode": "POST", "num_of_channels": 2, "audio_duration": 571.66 }, "transcript": [ { "text": "Hello, how can I help you today?", "time_start": 0, "time_end": 2.5, "speaker_id": 0, "speaker_alias": "Agent" }, { "text": "I\'d like to check my account balance.", "time_start": 1, "time_end": 5.1, "speaker_id": 1, "speaker_alias": "User" } ] } }', 'headers' => [ 'Content-Type' => 'application/json', 'apikey' => '{{apikey}}', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://https/webhooks/transcript-delivered"); var request = new RestRequest(Method.POST); request.AddHeader("apikey", "{{apikey}}"); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"status\": \"S001\",\n \"request_id\": \"f9f23b27019a553c04c2d4280d37fd42\",\n \"call_uuid\": \"call-abc123\",\n \"data\": {\n \"id\": \"29051cac-89b5-49ec-a932-006c8cc57-0febd3.wav\",\n \"metadata\": {\n \"sample_rate\": 16000,\n \"mode\": \"POST\",\n \"timestamp\": 1780635349,\n \"lang\": \"en\",\n \"codec\": \"\",\n \"transcribed_mode\": \"POST\",\n \"num_of_channels\": 2,\n \"audio_duration\": 571.66\n },\n \"transcript\": [\n {\n \"text\": \"Hello, how can I help you today?\",\n \"time_start\": 0,\n \"time_end\": 2.5,\n \"speaker_id\": 0,\n \"speaker_alias\": \"Agent\"\n },\n {\n \"text\": \"I'd like to check my account balance.\",\n \"time_start\": 1,\n \"time_end\": 5.1,\n \"speaker_id\": 1,\n \"speaker_alias\": \"User\"\n }\n ]\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "apikey": "{{apikey}}", "Content-Type": "application/json" ] let parameters = [ "status": "S001", "request_id": "f9f23b27019a553c04c2d4280d37fd42", "call_uuid": "call-abc123", "data": [ "id": "29051cac-89b5-49ec-a932-006c8cc57-0febd3.wav", "metadata": [ "sample_rate": 16000, "mode": "POST", "timestamp": 1780635349, "lang": "en", "codec": "", "transcribed_mode": "POST", "num_of_channels": 2, "audio_duration": 571.66 ], "transcript": [ [ "text": "Hello, how can I help you today?", "time_start": 0, "time_end": 2.5, "speaker_id": 0, "speaker_alias": "Agent" ], [ "text": "I'd like to check my account balance.", "time_start": 1, "time_end": 5.1, "speaker_id": 1, "speaker_alias": "User" ] ] ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://https/webhooks/transcript-delivered")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```