Templates
Register and send reviewed templates outside the customer window.
Use POST /v1/templates to register a template and
submit it for review. Review is asynchronous and may take an hour or longer for
a first submission. Use GET /v1/templates to read the
current status and accepted parameter shape.
Only an approved template can be sent. Approval is not permanent: a template
may later be paused for quality and become approved again. Read the registry
rather than caching approval forever.
For WhatsApp’s template categories, review rules, and lifecycle, see the WhatsApp Business Platform message template documentation. Linq’s template endpoints are the authority for the request and response shapes you use with this API.
A template send is validated against the registry before acceptance. A missing
or non-approved template, wrong language, or mismatched parameter set is
refused with HTTP 422 and error.code
4007. Linq never substitutes a
different template.
An authentication template with a one-time-code button (copy code, one-tap,
or zero-tap autofill) needs the customer’s phone number. Sent to a customer
known only by a
username id,
it cannot be delivered. When the stored template already identifies the
one-time-code button, the send is refused with HTTP 422 and error.code
4011, and nothing is sent. If the
refusal can only be known after acceptance, the message fails with
status: failed and failure.code: recipient_phone_number_required instead.