---
title: "Enviar Notificacao"
method: POST
path: "/send-notification"
tags: ["Notificacoes"]
---

# Enviar Notificacao

`POST /send-notification`

Envia mensagens template do WhatsApp Business via Meta Cloud API para contatos especificos.

O endpoint suporta dois formatos de payload: o formato moderno (baseado na estrutura de componentes da Meta API) e o formato legado (com substituicoes simples de texto).

## Request body

- SendNotificationRequest — Suporta dois formatos: moderno (com template) e legado (com messageTemplate + replacements).
  - `name` string, required — Nome do contato
  - `phoneNumber` string, required — Numero de telefone do contato
  - `email` string, email — Email do contato (opcional)
  - `instanceId` integer, required — ID da instancia do bot WhatsApp
  - `source` string, required — Origem da notificacao
  - `ignoreTransferToTalkIfUnanswered` boolean — Se true, nao transfere para o Talk caso o lead nao responda
  - `specialInstructions` string — Instrucoes especiais para a MIA ao responder o lead
  - `template` WhatsAppTemplate — Estrutura do template WhatsApp seguindo o padrao da Meta Cloud API
    - `name` string, required — Nome do template aprovado no Meta Business Manager
    - `language` object, required
      - `code` string, required — Codigo do idioma do template (ex: pt_BR)
    - `components` TemplateComponent[] — Componentes do template (header, body, button)
      - `type` 'header' | 'body' | 'button', required — Tipo do componente
      - `sub_type` 'url' | 'quick_reply' — Subtipo do componente (apenas para buttons)
      - `index` integer — Indice do botao (apenas para buttons)
      - `parameters` TemplateParameter[] — Parametros do componente
        - `type` 'text' | 'document' | 'image' | 'video', required — Tipo do parametro
        - `text` string — Valor do texto (quando type = text)
        - `document` object — Dados do documento (quando type = document)
          - `link` string, uri — URL do documento
          - `filename` string — Nome do arquivo
  - `messageTemplate` string — Nome do template de mensagem (formato legado)
  - `replacements` string[] — Substituicoes para os placeholders do template (formato legado)

## Response `200`

Notificacao enviada com sucesso

- SendNotificationResponse
  - `success` boolean — Indica se a notificacao foi enviada com sucesso
  - `conversationId` string, uuid — ID da conversa criada ou localizada

## Other responses

- `400` — Requisicao invalida
- `500` — Erro interno do servidor

---

[API](https://skmtc.dev/morada/apis/api-morada-ai.md) · [All operations](https://skmtc.dev/morada/apis/api-morada-ai/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/morada/api-morada-ai/revisions/9ce869fc8130/schema)