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

# Responder Mensagem

<Card title="Webhook relacionado: Responder" icon="bolt" href="/webhook-reference/events/responder" horizontal>
  Uma resposta dispara o evento **Responder**, com o id da mensagem citada.
</Card>

## Descrição

Este endpoint permite responder a mensagem de texto, multimídia, contato ou enquete, diretamente para um número ou grupo.

### Parâmetros Comuns

<ParamField body="appkey" type="string" required>
  Chave de aplicação.
</ParamField>

<ParamField body="authkey" type="string" required>
  Chave de autenticação do usuário.
</ParamField>

<ParamField body="to" type="string" required>
  Número de telefone no formato internacional ou ID do grupo.
</ParamField>

<ParamField body="message" type="string" required>
  Texto que será utilizado como resposta.
</ParamField>

<ParamField body="tipoMensagem" type="string" required>
  Tipo de mensagem enviada. Valores possíveis:

  * `"extendedTextMessage"`: Resposta com texto estendido
  * `"imageMessage"`: Resposta com imagem
  * `"conversation"`: Resposta com texto simples
  * `"videoMessage"`: Resposta com vídeo
  * `"pollCreationUpdate"`: Resposta com enquete
  * `"documentMessage"`: Resposta com arquivo/documento
</ParamField>

<ParamField body="tipo" type="string" required>
  Define o remetente. Valores: `"me"` ou `"chat"`.
</ParamField>

<ParamField body="idMensagem" type="string" required>
  ID da mensagem recebida que está sendo respondida.
</ParamField>

### Parâmetros Específicos

<ParamField body="respostaMensagem" type="string">
  Conteúdo de texto para respostas do tipo texto (necessário para mostrar o texto que foi respondido).
</ParamField>

<ParamField body="thumbnail" type="string">
  Conteúdo de imagem para respostas do tipo localização (URL ou BASE64).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://chatbot.menuia.com/api/create-message \
    -H "Content-Type: application/json" \
    -d '{
      "appkey": "SUA_APPKEY_AQUI",
      "authkey": "SUA_AUTHKEY_AQUI",
      "to": "+5511999999999",
      "message": "Que bom que você está bem",
      "tipoMensagem": "extendedTextMessage",
      "tipo": "chat",
      "respostaMensagem": "Tudo bem",
      "idMensagem": "F8B848F533D8805D321D5E1A6EBED388"
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://chatbot.menuia.com/api/create-message', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      appkey: 'SUA_APPKEY_AQUI',
      authkey: 'SUA_AUTHKEY_AQUI',
      to: '+5511999999999',
      message: 'Que bom que você está bem',
      tipoMensagem: 'extendedTextMessage',
      tipo: 'chat',
      respostaMensagem: 'Tudo bem',
      idMensagem: 'F8B848F533D8805D321D5E1A6EBED388'
    })
  });
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://chatbot.menuia.com/api/create-message',
      json={
          'appkey': 'SUA_APPKEY_AQUI',
          'authkey': 'SUA_AUTHKEY_AQUI',
          'to': '+5511999999999',
          'message': 'Que bom que você está bem',
          'tipoMensagem': 'extendedTextMessage',
          'tipo': 'chat',
          'respostaMensagem': 'Tudo bem',
          'idMensagem': 'F8B848F533D8805D321D5E1A6EBED388'
      }
  )
  ```

  ```php PHP theme={null}
  $response = Http::post('https://chatbot.menuia.com/api/create-message', [
      'appkey' => 'SUA_APPKEY_AQUI',
      'authkey' => 'SUA_AUTHKEY_AQUI',
      'to' => '+5511999999999',
      'message' => 'Que bom que você está bem',
      'tipoMensagem' => 'extendedTextMessage',
      'tipo' => 'chat',
      'respostaMensagem' => 'Tudo bem',
      'idMensagem' => 'F8B848F533D8805D321D5E1A6EBED388'
  ]);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Sucesso theme={null}
  {
    "status": 200,
    "message": "Resposta enviada com sucesso."
  }
  ```

  ```json 401 - Erro de validação theme={null}
  {
    "status": 401,
    "message": "validation.required"
  }
  ```

  ```json 404 - Dispositivo não encontrado theme={null}
  {
    "status": 404,
    "message": "Nenhum dispositivo encontrado."
  }
  ```
</ResponseExample>