> ## Documentation Index
> Fetch the complete documentation index at: https://help.wizebot.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar Modelo de Transmissão WhatsApp

> Enviar modelo de transmissão do WhatsApp para contatos

# Enviar Modelo de Transmissão

Esta API permite enviar modelos de mensagem em formato de transmissão (broadcast) para contatos através do WhatsApp.

## Modelos de Transmissão

Os modelos de transmissão permitem enviar mensagens para vários contatos simultaneamente usando templates pré-aprovados pelo WhatsApp. Isso é especialmente útil para campanhas de marketing, notificações e comunicações em massa.

## Endpoint da API

<ParamField method="POST" type="string">
  Enviar um modelo de transmissão para contatos via WhatsApp
</ParamField>

## Parâmetros

<ParamField query="apiToken" type="string" required>
  Sua chave de API
</ParamField>

<ParamField query="phone_number_id" type="string" required>
  Número de telefone da conta do WhatsApp ID
</ParamField>

<ParamField query="fluxo_de_dados" type="json" required>
  Passar dados de fluxo como formato JSON
</ParamField>

## Exemplo de Solicitação

<CodeGroup>
  ```bash POST theme={null}
  curl -X POST \ 
  'https://app.wizebot.com.br/api/v1/whatsapp/broadcast/template/send' \
  -d 'apiToken=API-KEY' \
  -d 'phone_number_id=PHONE-NUMBER-ID' \
  -d 'fluxo_de_dados={"dados":"do_fluxo"}'
  ```
</CodeGroup>

## Exemplo de Resposta

<CodeGroup>
  ```json Sucesso theme={null}
  {
    "status": "1",
    "visual_flow_campaign_id": 1727,
    "message": "Data has been saved successfully.",
    "redirect_on_success_url": ""
  }
  ```

  ```json Erro theme={null}
  {
    "status": "0",
    "message": "Invalid API Key."
  }
  ```
</CodeGroup>

## Teste a API

<Note>
  Para testar esta API, você precisará de sua chave API (apiToken) que pode ser encontrada no painel da WizeBot em Configurações > API.
</Note>

<Playground method="POST" endpoint="https://app.wizebot.com.br/api/v1/whatsapp/broadcast/template/send">
  ```json theme={null}
  {
    "apiToken": "SUA_API_KEY_AQUI",
    "phone_number_id": "SEU_PHONE_NUMBER_ID",
    "fluxo_de_dados": {
      "template_name": "nome_do_template",
      "language": "pt_BR",
      "recipients": [
        {
          "phone": "5511999999999",
          "parameters": {
            "nome": "João Silva",
            "produto": "Plano Premium"
          }
        }
      ]
    }
  }
  ```
</Playground>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST \
    'https://app.wizebot.com.br/api/v1/whatsapp/broadcast/template/send' \
    -d 'apiToken=SUA_API_KEY_AQUI' \
    -d 'phone_number_id=SEU_PHONE_NUMBER_ID' \
    -d 'fluxo_de_dados={"template_name":"nome_do_template","language":"pt_BR","recipients":[{"phone":"5511999999999","parameters":{"nome":"João Silva","produto":"Plano Premium"}}]}'
  ```

  ```javascript Node.js theme={null}
  const axios = require('axios');

  const data = {
    apiToken: 'SUA_API_KEY_AQUI',
    phone_number_id: 'SEU_PHONE_NUMBER_ID',
    fluxo_de_dados: {
      template_name: 'nome_do_template',
      language: 'pt_BR',
      recipients: [
        {
          phone: '5511999999999',
          parameters: {
            nome: 'João Silva',
            produto: 'Plano Premium'
          }
        }
      ]
    }
  };

  axios.post('https://app.wizebot.com.br/api/v1/whatsapp/broadcast/template/send', data)
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error('Erro:', error);
  });
  ```

  ```php PHP theme={null}
  <?php
  $url = 'https://app.wizebot.com.br/api/v1/whatsapp/broadcast/template/send';

  $fluxo_dados = array(
    'template_name' => 'nome_do_template',
    'language' => 'pt_BR',
    'recipients' => array(
      array(
        'phone' => '5511999999999',
        'parameters' => array(
          'nome' => 'João Silva',
          'produto' => 'Plano Premium'
        )
      )
    )
  );

  $data = array(
    'apiToken' => 'SUA_API_KEY_AQUI',
    'phone_number_id' => 'SEU_PHONE_NUMBER_ID',
    'fluxo_de_dados' => json_encode($fluxo_dados)
  );

  $options = array(
    'http' => array(
      'header'  => "Content-type: application/x-www-form-urlencoded\r\n",
      'method'  => 'POST',
      'content' => http_build_query($data)
    )
  );

  $context  = stream_context_create($options);
  $result = file_get_contents($url, false, $context);

  echo $result;
  ?>
  ```
</RequestExample>

<ResponseExample>
  ```json Sucesso theme={null}
  {
    "status": "1",
    "visual_flow_campaign_id": 1727,
    "message": "Data has been saved successfully.",
    "redirect_on_success_url": ""
  }
  ```

  ```json Erro - API Key Inválida theme={null}
  {
    "status": "0",
    "message": "Invalid API Key."
  }
  ```

  ```json Erro - Parâmetros Inválidos theme={null}
  {
    "status": "0",
    "message": "Missing required parameters."
  }
  ```
</ResponseExample>