Creates a new message template.

Parameters

• template_data: A map containing the following keys:
  • :name (string, required): Template name (maximum 512 characters).
  • :category (string, required): Template category (AUTHENTICATION, MARKETING, UTILITY).
  • :language (string, required): Template language and locale code (e.g., "en_US").
  • :components (list, required): Array of template components.
  • :parameter_format (string, optional): The type of parameter formatting for HEADER and BODY components. Can be either NAMED or POSITIONAL. Defaults to POSITIONAL if not specified.
  • :library_template_name (string, optional): Exact name of the Utility Template Library template.
  • :library_template_button_inputs (list, optional): Array of objects for website and/or phone number used in the template.

Notes

• Previously, allow_category_change was supported to allow WhatsApp to update a template's category if they determined a different category was more appropriate. This behavior is now the default and the property is no longer needed.

Example

iex> template_data = %{
...>   name: "order_confirmation",
...>   category: "UTILITY",
...>   language: "en_US",
...>   parameter_format: "NAMED",
...>   components: components
...> }
iex> WhatsappElixir.Templates.create_template(template_data)
{:ok, %{"id" => "123456", "status" => "PENDING", "category" => "UTILITY"}}

Validation

• Raises ArgumentError if required fields (name, category, language, components) are missing.

Deletes a message template by ID, name, or both.

Parameters

• template_id: The ID of the template to delete (optional).
• name: The name of the template to delete (optional).

Example

iex> WhatsappElixir.Templates.delete_template("123456", "order_confirmation")
{:ok, %{"success" => true}}

iex> WhatsappElixir.Templates.delete_template(nil, "order_confirmation")
{:ok, %{"success" => true}}

iex> WhatsappElixir.Templates.delete_template("123456", nil)
{:ok, %{"success" => true}}

Edits an existing message template.

Parameters

• template_id: The ID of the template to edit.
• params: A map containing the properties to be edited:
  • category: New category for the template (optional).
  • components: New components for the template (optional).

Example

iex> params = %{"category" => "MARKETING", "components" => new_components}
iex> WhatsappElixir.Templates.edit_template("123456", params, custom_configs)
{:ok, %{"success" => true}}

Lists message templates.

Parameters

• fields: Comma-separated list of fields to include in the response (optional).
• limit: Maximum number of templates to return (optional).

Example

iex> WhatsappElixir.Templates.list_templates("name,status", 10)
{:ok, %{"data" => [%{"name" => "template1", "status" => "APPROVED"}]}}

Retrieve template namespace

Example

iex(7)> WhatsappElixir.Templates.retrieve_template_namespace(custom_configs) {:ok, %{

"id" => "375688788962938",
"message_template_namespace" => "87c5159f_1423_4819_8fe3_11e731b2d492"

}}