Skip to content

Formulário de contato ​

O mesmo formulário atende contato geral e dúvidas sobre o produto apresentado. O manifesto declara "contact": "templates/contact.json" e esse template inclui a section contact. Os hooks são processados pelo runtime compartilhado.

Opções no editor visual ​

Nos 20 temas oficiais, a seção Contato permite editar título, apresentação, texto de atendimento (horários e prazo de resposta) e texto do botão. Também permite mostrar ou ocultar o telefone opcional e o caminho Início / Contato, e escolher formulário centralizado ou informações ao lado. No celular, a disposição lateral é empilhada. Cores e fontes continuam seguindo o tema.

Essas escolhas ficam nos settings da seção; a definição está em editor.json. Nome, e-mail e mensagem permanecem obrigatórios. Destinatário e regras de envio não são configurações do Liquid. Textos não interpretam HTML; título e botão vazios usam o texto original, e os demais textos vazios não são exibidos.

Revisões com editor visual e formulário oficial anterior intacto recebem as opções ao abrir Contato. Aplicar uma edição salva a preparação no rascunho; a publicação continua explícita. Formulários personalizados ou preparados como platform_contact_v1 e revisões sem editor visual são preservados.

Exemplo sem configurações visuais ​

O exemplo abaixo é o contrato mínimo, sem depender de editor.json.

Em uma revisão antiga sem contato, a plataforma prepara o formulário oficial no rascunho, usando templates/platform_contact_v1.json e sections/platform_contact_v1.liquid. A IA adapta a aparência e inclui o botão; o servidor acrescenta exclusivamente o papel contact à configuração. Não é necessário liberar edição de theme.json nem trocar o tema. O contato existente é preservado. A preparação inclui CSS responsivo de base no entrypoint do tema, com prioridade menor que as regras personalizadas. Rascunhos preparados sem essa base podem recebê-la em um pedido de correção visual, sem recriar o formulário. Confira a prévia e publique a nova revisão explicitamente. O exemplo abaixo representa a composição livre de um tema que já declara contato.

json
{ "sections": [{ "id": "contact", "type": "contact" }] }
liquid
<section id="{{ section.id }}" class="contact-page">
  <nav class="breadcrumb" aria-label="Navegação estrutural">
    <a href="{{ '/' | storefront_url }}">Início</a>
    <span aria-hidden="true">/</span>
    <span aria-current="page">Contato</span>
  </nav>
  <h1>Fale com a loja</h1>
  <p>Envie sua mensagem. Vamos responder pelo e-mail que você informar.</p>
  {% if product %}
    <div class="contact-product">
      {% if product.mainImage %}<img src="{{ product.mainImage.thumbUrl | default: product.mainImage.url }}" alt="{{ product.name }}" width="80" height="80">{% endif %}
      <p>Sua dúvida é sobre<br><a href="{{ product.url | storefront_url }}">{{ product.name }}</a></p>
    </div>
  {% endif %}
  {% if capabilities.contact %}
    <form class="contact-form" data-contact-form method="post" action="{{ '/api/contact' | storefront_url }}">
      {% if product %}<input type="hidden" name="productId" value="{{ product.id }}">{% endif %}
      <fieldset>
        <legend class="visually-hidden">Sua mensagem para a loja</legend>
        <label for="contact-name-{{ section.id }}">Nome</label>
        <input id="contact-name-{{ section.id }}" name="name" autocomplete="name" required minlength="2" maxlength="150">
        <label for="contact-email-{{ section.id }}">E-mail</label>
        <input id="contact-email-{{ section.id }}" name="email" type="email" autocomplete="email" required maxlength="100">
        <label for="contact-phone-{{ section.id }}">Telefone (opcional)</label>
        <input id="contact-phone-{{ section.id }}" name="phone" type="tel" autocomplete="tel" maxlength="45">
        <label for="contact-message-{{ section.id }}">Mensagem</label>
        <textarea id="contact-message-{{ section.id }}" name="message" required minlength="10" maxlength="5000" rows="6" aria-describedby="contact-privacy-{{ section.id }}"></textarea>
        <div hidden aria-hidden="true"><label>Deixe este campo vazio<input name="website" tabindex="-1" autocomplete="off"></label></div>
      </fieldset>
      <p id="contact-privacy-{{ section.id }}" class="contact-note">Usaremos seus dados para responder à sua solicitação. Não envie senhas nem dados de cartão.</p>
      <button type="submit">Enviar mensagem</button>
      <p data-contact-message role="status" aria-live="polite" aria-atomic="true"></p>
      <noscript><p>Ative o JavaScript para enviar sua mensagem com segurança.</p></noscript>
    </form>
  {% else %}
    <p role="status">O formulário está indisponível no momento. Utilize outro canal de atendimento da loja.</p>
  {% endif %}
</section>

O CSS pertence ao tema. Use labels visíveis, contraste adequado, espaçamento, inputs com ao menos 16px e botão de fácil acionamento no celular. O botão fica fora do fieldset para permitir retry quando os campos estiverem bloqueados. O exemplo renderiza sem scripts próprios; a prévia não envia.

Veja o contrato do runtime e as orientações para receber as mensagens.

Temas V3 · Liquid estrutura, CSS desenha, JSON compõe.