创建模板
Create WhatsApp Business template
OpenAPI
/api-reference/openapi/WTO-WA-API/template.yaml post /template/create/{instanceName}
openapi: 3.0.4
info:
title: WTO - WTO WA API - Template
description: Main WTO WA API for WhatsApp
version: 2.3.7
servers:
- url: http://localhost:8080
description: Local development server
- url: https://api.wtocrm.com
description: Production server
- url: '{customUrl}'
description: Custom server
variables:
customUrl:
default: https://your-instance.com
description: Enter your server URL
security:
- ApiKeyAuth: []
paths:
/template/create/{instanceName}:
post:
summary: Create Template
description: Create WhatsApp Business template
parameters:
- $ref: '#/components/parameters/InstanceName'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
- category
- language
- components
properties:
name:
type: string
category:
type: string
enum:
- MARKETING
- UTILITY
- AUTHENTICATION
language:
type: string
components:
type: array
items:
type: object
responses:
'200':
description: Template created successfully
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
template:
type: object
example:
success: true
template:
id: template-id
name: template_name
status: APPROVED
'400':
description: Bad Request - Invalid input data
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
error:
code: BAD_REQUEST
message: >-
Invalid request data. Name, category, language, and
components are required.
meta:
timestamp: '2024-01-15T10:30:00Z'
path: /template/create/{instanceName}
method: POST
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
error:
code: UNAUTHORIZED
message: Invalid or missing API key
meta:
timestamp: '2024-01-15T10:30:00Z'
path: /template/create/{instanceName}
method: POST
'403':
description: Forbidden - Insufficient permissions
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
error:
code: FORBIDDEN
message: Insufficient permissions to create template
meta:
timestamp: '2024-01-15T10:30:00Z'
path: /template/create/{instanceName}
method: POST
'404':
description: Not Found - Instance not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
error:
code: NOT_FOUND
message: Instance not found
meta:
timestamp: '2024-01-15T10:30:00Z'
path: /template/create/{instanceName}
method: POST
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
success: false
error:
code: INTERNAL_SERVER_ERROR
message: An unexpected error occurred
meta:
timestamp: '2024-01-15T10:30:00Z'
path: /template/create/{instanceName}
method: POST
components:
parameters:
InstanceName:
name: instanceName
in: path
required: true
description: WhatsApp instance name
schema:
type: string
example: my-instance
schemas:
ErrorResponse:
type: object
required:
- success
- error
properties:
success:
type: boolean
example: false
error:
type: object
required:
- code
- message
properties:
code:
type: string
message:
type: string
meta:
type: object
properties:
timestamp:
type: string
format: date-time
path:
type: string
method:
type: string
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: apikey
description: API Key for authentication (global or instance-specific)